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SUMMARY 


This  report  describes  the  procedures  for  using  the  SAINT 
simulation  program  to  analyze  system  models.  SAINT  (Systems 
Analysis  of  Integrated  Networks  of  Tasks)  is  a network  model- 
ing and  simulation  technique  designed  to  aid  the  system  de- 
signer and  human  engineer  in  analyzing  complex  man-machine 
systems.  It  provides  the  conceptual  framework  which  allows 
the  development  of  system  models  in  which  men,  machines,  and 
the  environment  are  represented.  It  permits  the  assessment 
of  the  effect  of  the  component  characteristics  of  the  system 
on  overall  system  performance.  The  symfeo^ism  and  terminology 
required  for  modeling  systems  using  (“SAINT' are  introduced  and 
described  in  Simulation  Using  SAINT:  A~  tTSer-Oriented  Instruc- 
tion Manual  (1).  The  overall  structure  and  individual  FORTRAN 
subprograms  of  SAINT  are  described  in  Documentation  for  the 
SAINT  Simulation  Program  (2) . The  use  of  an  external  statis- 
tical analysis  package  to  analyze  SAINT  output  is  described 
in  Analyzing  SAINT  Output  Using  SPSS  (3) . 

In  this  manual,  the  SAINT  symbol  set  and  terminology  that 
are  presented  in  detail  in  Simulation  Using  SAINT:  A User- 
Oriented  Instruction  Manual  (1)  are  summarized.  The  prepara- 
tion of  input  data  and  the  organization  of  the  input  deck  are 
described.  The  functions  performed  by  the  user-written  sub- 
programs included  in  SAINT  are  defined.  The  procedures  for 
using  the  available  user  support  subprograms  are  presented. 

The  errors  that  SAINT  can  detect,  as  well  as  the  probable 
cause  of  each  error,  are  provided.  Information  concerning 
the  operation  and  structure  of  the  SAINT  simulation  program 
is  also  presented. 


PREFACE 


This  study  was  initiated  by  the  Human  Engineering 
Division,  Aerospace  Medical  Research  Laboratory,  Wright- 
Patterson  Air  Force  Base,  Ohio  45433.  The  research  was 
conducted  by  Pritsker  & Associates,  Inc.,  P.  0.  Box  2413, 
West  Lafayette,  Indiana  47906.  The  work  was  performed 
in  support  of  Project  7184  "Man-Machine  Integration 
Technology,”  task  718413  "Man-Machine  Models  for  System 
Performance  Assessment."  The  research  sponsored  by  this 
contract  was  performed  between  August,  1975  and  December, 
1976,  under  Air  Force  contract  F33ST5-76-C-5012 . 

In  developing  the  SAINT  technique,  the  authors  re- 
ceived guidance  and  assistance  from  many  individuals,  es- 
pecially the  staff  members  of  Pritsker  & Associates  and 
the  Aerospace  Medical  Research  Laboratory.  We  appreciate 
their  efforts  and  acknowledge  their  contributions. 
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SECTION  I 


INTRODUCTION 


SAINT  provides  a unique  and  powerful  capability  for 
modeling  and  analyzing  complex  man-machine  systems.  The 
technique's  conceptual  framework  allows  the  development 
of  system  models  in  which  men,  machines,  and  the  environment 
are  represented.  This  permits  an  analyst  to  investigate 
the  impact  of  modifications  to  the  man-machine-environment 
interface  on  overall  system  performance.  In  addition,  such 
investigations  can  be  performed  without  a major  investment 
in  equipment  and  time  and  without  necessitating  a commitment 
to  prototype  hardware  development. 

SAINT  enables  an  analyst  to  input  a description  of 
the  system  to  be  analyzed.  The  system  description  includes 
the  tasks  performed  by  the  resources,  the  precedence  relations 
among  tasks,  the  flow  of  information  through  the  system,  and 
the  effects  of  environmental  stressors  on  task  performance. 
SAINT  also  allows  the  specification,  evaluation,  and  monitoring 
of  state  variables  which  represent  processes  that  change  status 
continously  over  time.  In  addition,  modeling  capabilities 
are  available  for  representing  the  dynamic  interaction  of 
tasks,  resources,  and  state  variables  in  an  overall  systems 
context . 

The  system  description  serves  as  input  data  to  the  SAINT 
simulation  program.  SAINT  automatically  performs  an  analysis 
of  the  model  developed  and  provides  summary  information 
concerning  resource  utilization,  task  performance,  state 
variable  status,  and  a wide  variety  of  other  system  perfor- 
mance measures.  In  addition,  SAINT  allows  the  user  to  develop 
his  own  special  summary  reports. 

The  SAINT  simulation  technique  is  documented  in  three 
manuals.  Simulation  Using  SAINT;  A User-Oriented  Instruc- 
tion Manual  (1)  provides  an  analyst  with  the  modeling  concepts 
necessary  to  build  SAINT  models.  This  manual.  The  SAINT 
User's  Manual,  contains  all  of  the  information  necessary 
to  use  the  SAINT  simulation  program  to  analyze  SAINT  models. 

It  is  designed  to  be  used  after  the  SAINT  modeling  concepts 
are  understood.  Documentation  for  the  SAINT  Simulation 
Program  (2)  serves  as  a complete  reference  guide  to  the 
inner  workings  of  the  SAINT  simulation  program. 
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SECTION  II 


SAINT  SYMBOLISM 

: i 

I 

►i 

The  basic  element  of  a SAINT  network  is  a task.  The 

1 symbol  used  to  portray  tasks  in  a SAINT  model  is  shown  in 

Figure  1.  Three  basic  functions  are  associated  with  each 
task  in  a SAINT  network:  1)  release  of  the  task  (satisfy- 
ing all  predecessor  requirements) ; 2)  performance  of  the 

task  and  associated  operations;  and  3)  identification  of 
potential  successor  tasks.  These  three  functions  are  de- 
scribed by  an  input  side,  a task  description,  and  an  output 
side.  Each  portion  of  the  task  symbol  will  now  be  described. 


Task  Input 

The  number  and  nature  of  predecessor  requirements  for 
the  release  of  a task  are  shown  on  the  input  side  of  the 
task  symbol.  The  number  of  predecessor  completions  required 
for  first  release  of  the  task  (PR1)  is  at  the  top,  while 
the  number  of  predecessor  completions  required  for  subsequent 
release  of  the  task  (PR2)  is  at  the  bottom. 
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TSK 

PR1 

PR2 


task  number 

number  of  predecessor  completions  required 
for  first  release  of  the  task 

number  of  predecessor  completions  required 
for  subsequent  release  of  the  task 


Figure  1.  Task  Symbol. 
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Task  Description 

The  center  portion  of  the  task  symbol  shown  in  Figure  1 
contains  all  task  description  information;  such  as  performance 
time  characteristics,  statistics  to  be  collected,  and  attri- 
butes to  be  assigned.  It  is  subdivided  into  rows,  with  each 
row  containing  a specific  type  of  descriptive  information  about 
the  task.  Further,  each  row  is  divided  into  two  parts.  The 
left-hand  part  contains  the  task  description  code.  It  is  used 
to  identify  the  type  of  information  that  appears  in  the  right- 
hand  part  of  the  row,  and  can  be  any  of  the  17  available  codes 
shown  in  Table  1.  By  using  the  description  code,  only  the 
information  necessary  to  describe  a task  need  be  shown  on 
the  task  symbol.  In  this  manner,  any  or  all  of  the  task  de- 
scription codes  can  be  specified  for  a particular  task.  If 
more  than  the  four  rows  provided  are  required  for  a complete 
description,  the  user  simply  adds  the  necessary  number  of 
additional  rows  to  the  bottom  of  the  task  description  portion 
of  the  task  symbol. 

In  the  ensuing  discussion,  each  of  the  17  available  task 
description  codes  will  be  described.  The  type  of  information 
that  is  identified  by  the  code  will  be  defined.  In  addition, 
examples  will  be  shown  that  demonstrate  the  use  of  each  code 
in  describing  a task.  However,  remember  that  the  examples 
are  only  intended  as  guidelines.  The  SAINT  user  should  employ 
a format  that  is  convenient  for  his  modeling  and  communication 
purposes.  Caution  should  be  exercised  in  developing  new 
formats,  as  it  is  desirable  that  other  SAINT  modelers  be  able 
to  read  the  network  and  understand  the  model.  Many  of  the  task 
description  rows  correspond  to  SAINT  input  cards.  Thus,  a 
trade-off  exists  between  the  ease  of  preparing  SAINT  input 
cards  from  the  network  model  and  the  ease  of  communicating  the 
characteristics  of  the  SAINT  model  to  others. 


ATAS 


The  code  ATAS  identifies  a row  containing  the  attribute 
assignments  to  be  made  at  the  task.  For  example,  if  informa- 
tion attribute  2 is  to  be  assigned  a value  drawn  from  distri- 
bution set  3 at  the  time  the  task  is  completed,  then  the  ATAS 
row  could  appear  as 


ATAS 


COM: 


IA, 2=DS , 3 


However,  if  the  value  of  attribute  4,  resource  7,  is  to  be 
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TABLE  1 


TASK  DESCRIPTION  CODES 


Description 

Code 

Information  Required  by  Description  Code 

ATAS 

attribute  assignments  to  be  performed 

DIFF 

different  predecessor  option 

DMOD 

distribution  set  modifications  to  be  made 

INCM 

information  choice  mechanism  decision  mode 

LABL 

label  associated  with  task 

MARK 

marking  information 

MODF 

moderator  functions  to  be  applied  to  task 
performance 

PREC 

completion  precedence 

PRTY 

priority 

RCLR 

resource  clearing  to  be  performed 

REGL 

regulation  to  be  performed 

RESR 

resource  requirements 

STAT 

statistics  to  be  collected 

SWIT 

switching  to  be  performed 

TCLR 

task  clearing  to  be  performed 

TIME 

performance  time  characteristics 

UTCH 

user-defined  task  characteristics 
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assigned  a value  calculated  in  user  function  11  at  the  start 
of  the  task,  then  the  ATAS  row  could  appear  as 

! 


[* 

>• 


ATAS 


START:  RA, 7-4=UF ,11 


If  both  assignments  described  above  are  to  be  made  when 
the  task  is  released,  then  the  ATAS  row  could  appear  as 


ATAS 


REL:  (IA,2=DS,3) , (RA, 7-4=UF , 11) 


DIFF 

The  code  DIFF  identifies  a row  containing  the  different 
predecessor  requirements  of  the  task.  If  different  predeces- 
sor completions  are  required  in  order  for  the  task  to  be  re- 
leased, then  the  DIFF  row  could  appear  as 


DIFF 


YES 


If  different  predecessors  are  not  required,  the  DIFF  row 
could  be  left  out  of  the  task  description  or  could  appear  as 


DIFF 


NO 


DMO  D 

The  code  DMOD  identifies  a row  containing  the  distribu- 
tion set  modifications  to  occur  upon  completion  of  the  task. 
If  distribution  set  3 is  to  be  replaced  by  distribution  set 
5,  then  the  DMOD  row  could  appear  as 


j 


i 

I 


DMOD 


5 
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or  as 


1 

4 


i 


i 

INCM 


DMO  D 


DS , 3 


DS , 5 


The  code  INCM  identifies  a row  containing  the  infor- 
mation choice  mechanism  decision  mode.  If  the  information 
packet  arriving  with  the  first  predecessor  completion  is  to 
be  saved,  then  the  INCM  row  could  appear  as 


INCM 


FIRST 


If  the  information  packet  with  the  smallest  value  of  attri- 
bute 2 is  to  be  saved,  then  the  INCM  row  could  appear  as 


INCM 


SMALL, 2 


LABL 

The  code  LABL  identifies  a row  containing  the  label 
assigned  to  the  task.  On  the  network,  the  task  label  can 
be  of  any  length.  However,  only  eight  alphanumeric  charac- 
ters are  recognized  by  the  SAINT  input  processor. 

Assume  that  a task  represents  the  action  of  traveling 
to  a desired  location.  A task  description  row  could  then 
appear  as 


i 

t 

i 


4 

MARK 


The  code  MARK  identifies  a row  containing  marking  infor- 
mation. If  marking  is  to  take  place  at  the  time  of  release 
of  the  task,  then  the  MARK  row  could  appear  as 


LABL 


TRAVEL  TO  NEW  LOCATION 


MARK 


RELEASE 


If  the  marking  is  to  take  place  upon  completion  of  the  task, 
then  the  MARK  row  could  appear  as 


or  as 


MODF 

The  code  MODF  identifies  a row  containing  the  moderator 
functions  to  be  applied  to  task  performance.  For  example, 
if  moderator  function  1 represents  a speed  function  and 
moderator  function  5 represents  an  environmental-related 
function,  and  both  are  to  be  applied  to  this  task,  then  the 
MODF  row  could  appear  as 


or  as 


PREC 

The  code  PREC  identifies  a row  containing  the  task 
completion  precedence  value.  If  two  tasks  are  completed 
at  the  same  time,  the  task  with  the  higher  PREC  value  will 
be  processed  first.  If  the  completion  precedence  is  15, 
then  the  PREC  row  could  appear  as 
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PREC 


15. 


PRTY 


The  code  PRTY  identifies  a row  containing  the  task 
priority  used  for  scheduling  purposes.  If  the  priority 
of  the  task  is  5,  then  the  PRTY  row  could  appear  as 


PRTY 


5. 


RCLR 


The  code  RCLR  identifies  a row  containing  the  resources 
to  be  cleared  and  the  associated  tasks  to  be  signaled  upon 
task  completion.  If  resource  1 is  to  be  cleared  and  task  53 
is  to  be  signaled,  and  resource  5 is  to  be  cleared  and  no  task 
signaled,  then  the  RCLR  row  could  appear  as 


RCLR 

(CLR  1 , SIG  53) , (CLR  5) 

RCLR 

(Cl ,S53) , (C5 ,N0  SIGNAL) 

REGL 


The  code  REGL  identifies  a row  containing  the  state 
variable  regulation  to  be  performed  upon  task  completion. 

If  the  value  of  SS(16)  is  to  be  set  to  5.*SS(4)+3.,  then  the 
REGL  row  could  appear  as 


REGL 


SS  ( 16 ) -►  5 . *SS  ( 4 ) +3. 


If  the  value  of  SS(16)  is  to  be  decreased  by  the  same  regulating 
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function,  then  the  REGL  row  could  appear  as 


REGL 


SS  (16)  i 5 . *SS (4 ) +3 . 


RESR 


The  code  RESR  identifies  a row  containing  the  resource 
requirements  of  the  task.  If  the  task  requires  resources  1, 
5,  and  7 for  performance,  then  the  RESR  row  could  appear  as 


RESR 


AND:  1,5,7 


or  as 


RESR 


AND:  1 (PLUMBER) ,5 (HAMMER) ,7 (WRENCH) 


If  the  task  requires  only  one  resource,  and  it  must  be  either 
resource  2 or  resource  3,  then  the  RESR  row  could  appear  as 


RESR 


OR: 


2,3 


STAT 


The  code  STAT  identifies  a row  containing  the  statistics 
to  be  collected  at  the  task.  For  example,  assume  that  sta- 
tistics are  to  be  collected  on  the  time  between  s arts  of 
the  task.  Further  assume  that  the  histogram  to  be  generated 
contains  25  cells,  with  the  upper  limit  of  the  fir  t cell 
being  20  and  the  cell  width  being  15.  Then  the  'TAT  row 
could  appear  as 


STAT 


BETWEEN  STARTS 
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or  as 


STAT 


BET  STA 


or  as 


STAT 


BET  STA  (25. ,20. ,15.) 


SWIT 


The  code  SWIT  identifies  a row  containing  the  switching 
to  be  performed  upon  task  completion.  If  the  value  of 
switch  3 is  to  be  set  to  152,  then  the  SWIT  row  could  appear 
as 


SWIT 


IS, 3=152 


or  as 


SWIT 


SET  SWITCH  3 TO  152 


TCLR 


The  code  TCLR  identifies  a row  containing  the  tasks  to 
be  cleared  and  the  associated  tasks  to  be  signaled  upon  task 
completion.  For  example,  if  task  27  is  to  be  cleared  and 
task  39  is  to  be  signaled  upon  completion  of  this  task,  then 
the  TCLR  row  could  appear  as 


TCLR 


27,39 


or  as 
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TCLR 

CLEAR  27, SIGNAL  39 

TIME 

The  code  TIME  identifies  a row  containing  the  perfor 
mance  time  characteristics.  If  the  task  time  is  located 
distribution  set  3,  then  the  TIME  row  could  appear  as 

TIME 

DS , 3 

or  as 

TIME 

DS , 3 (NORMAL, ME AN= 5. 75) 

If  the  task  performance  time  is  located  in  attribute  5 of 
resource  1,  then  the  TIME  row  could  appear  as 

| TIME 

RA, 1-5 

UTCH 


The  UTCH  code  identifies  a row  containing  the  user- 
defined  task  characteristics  of  the  task.  If  the  task  requires 
user-defined  task  characteristics  1,  5,  and  6;  and  they  have 
values  of  2.75,  1.9,  and  2,  respectively;  then  the  UTCH  row 
could  appear  as 


UTCH 


(1,2.75) , (5,1.9) , (6,2.) 


Examples  of  Task  Descriptions 

In  the  previous  discussion,  definitions  and  examples 
of  the  17  available  description  codes  were  presented.  The 
following  examples  show  how  the  individual  description  rows 
can  be  integrated  to  form  a complete  task  description. 
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Example  1 


Task  5 represents  the  operation  of  fixing  a sink.  The  base- 
line time  to  perform  the  task  is  a deviate  drawn  from  distri- 
bution set  3.  It  is  to  be  performed  with  resources  1,  3, 
and  5.  Moderator  functions  1 and  2 are  to  be  applied  to 
task  performance. 


Example  2 


The  time  to  perform  task  27  is  located  in  attribute  15  of 
resource  3.  Upon  completion  of  the  task,  information 
attribute  5 is  to  be  assigned  a value  calculated  in  user 
function  4.  Interval  statistics  (time  since  the  last 
marking)  are  to  be  collected  upon  task  completion.  Finally, 
the  value  of  switch  5 is  to  be  set  to  20.  In  addition, 
different  predecessor  completions  are  required  in  order  for 
the  task  to  be  released. 


Example  3 


The  time  to  perform  task  54  (a  source  task,  since  it  requires 
no  predecessor  completions  for  release)  is  calculated  in 
user  function  18.  The  priority  for  scheduling  purposes  is 
129.23.  Marking  is  to  take  place  when  the  task  is  released. 
When  task  54  is  completed,  resources  1 and  5 are  to  be 
cleared,  and  tasks  15  and  23  are  to  be  signaled.  In  addition, 
SS(4)  is  to  be  increased  in  value  by  SS(27)+3.25. 


Example  4 


Task  17  takes  10  time  units  to  perform.  The  information 
packet  with  the  biggest  value  of  attribute  11  will  be  saved. 
The  completion  precedence  is  10.  The  value  assigned  to 
user-defined  task  characteristic  1 is  2.75,  and  the  value 
of  user-defined  task  characteristic  2 is  157.  When  the  task 
is  completed,  distribution  set  10  is  replaced  by  distribu- 
tion set  21,  task  35  is  cleared,  and  task  14  is  signaled. 


Task  Output 

Each  task  in  a SAINT  network  is  uniquely  identified  by 
a task  number  shown  on  the  output  side  of  the  task  symbol. 

The  shape  of  the  output  side  indicates  the  type  of  branching 
operation  to  be  performed  upon  task  completion  (deterministic, 
probabilistic,  conditional-take  first,  or  conditional- 
take  all) . The  symbols  for  the  four  types  of  branching 
operations  available  in  SAINT  are  shown  in  Table  2. 

Tables  3 and  4 define  and  present  examples  of  the  branch 
codes  for  probabilistic  and  conditional  branching.  Deter- 
ministic branching  requires  no  branch  codes. 
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TABLE  2 


Branching 

TyPe 


Deterministic 


Probabilistic 


Conditional- 
Take  First 


Conditional- 
Take  All 


AVAILABLE  BRANCHING  TYPES 


Symbol 


Description  of  Branching  Operation 

All  branches  emanating  from  this 
task  will  be  selected. 


One  and  only  one  of  the  branches 
emanating  from  this  task  will  be 
selected.  The  selection  is  made 
on  a random  basis  using  the 
probabilities  associated  with 
the  branches. 


One  and  only  one  of  the  branches 
emanating  from  this  task  will  be 
selected.  The  branches  are  rank 
ordered  and  the  associated  con- 
ditions are  tested.  When  one  of 
the  conditions  is  satisfied,  the 
associated  branch  is  selected. 


All  branches  whose  conditions  are 
satisfied  will  be  selected.  As 
with  conditional-take  first 
branching,  the  branches  are  rank 
^prdered  and  the  associated  con- 
ditions are  tested.  All  branches 
emanating  from  the  task  are 
tested  for  possible  selection. 
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TABLE  3 


PROBABILISTIC  BRANCHING  CODES 


Branch 

Code  Description 


(p)  Probability  of  selection  equals  p 

(T , A)  Probability  of  selection  equals  the 

value  of  attribute  A of  type  T 


Examples  of  the  branch  codes  are: 


(0.75) 

Probability  of  selecting  branch  is 

0.75 

(IA,7) 

Probability  of  selecting  branch  is 
value  of  information  attribute  7 

the 

(RA, 5-3) 

Probability  of  selecting  branch  is 
value  of  resource  5,  attribute  3 

the 

(SA, 25) 

Probability  of  selecting  branch  is 
value  of  system  attribute  25 

the 
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TABLE  4 


Branch 

Code 

(TLV, x) 

(TGV , x) 

(TLA,T, A) 

(TGA,T,A) 

(TVC,N) 

(TVN,N) 

(TAC,T,A) 

(TAN,T,A) 

(ALV,T, A,x) 
(AGV,T, A,x) 
(ALA,T,A,B) 
(AGA,T,A,B) 

Definitions 

TNOW 

.LE. 

.GT. 

x 

V (Tf  A) 
V (T,B) 


CONDITIONAL  BRANCHING  CODES 

Description  of  Condition  for  Selecting  Branch 
TNOW. LE. x 
TNOW.GT.x 
TNOW.LE.V (T,A) 

TNOW. GT . V (T , A) 

Task  N has  been  completed 

Task  N has  not  been  completed 

Task  identified  as  v(T,A)  has  been  completed 

Task  identified  as  v(T,A)  has  not  been 
completed 

v (T,A) .LE.x 
V (T, A) . GT.x 
V (T,  A)  . LE . v (T, B) 

V (T, A) . GT . V (T, B) 

of  the  terms  used  in  the  descriptions  are: 

Current  simulation  time  (time  of  task 
completion) 

"less  than  or  equal  to" 

"greater  than" 

specified  real  value 

value  of  attribute  A of  type  T 

value  of  attribute  B of  type  T 
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Examples  of  the  branch  codes  are 


(TLV,5.75)  Select  branch  if  time  of  task  completion 
is  less  than  or  equal  to  5.75 

(TGA,IA,7)  Select  branch  if  time  of  task  completion 
is  greater  than  the  value  of  information 
attribute  7 

(TVC,35)  Select  branch  if  task  35  has  been  completed 

(TAN, RA, 4-1)  Select  branch  if  the  task  whose  number  is 
the  value  of  resource  4,  attribute  1,  has 
not  been  completed 

(ALV,SA, 12, 2. 3)  Select  branch  if  the  value  of  system  attri- 
bute 12  is  less  than  or  equal  to  2.3 

(AGA,IA,3,5)  Select  branch  if  the  value  of  information 
attribute  3 is  greater  than  the  value  of 
information  attribute  5 


I 

! 


'I 
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Additional  Task  Modeling  Concepts 

Task  modification  involves  the  substitution  of  the  task 
description  and  output  side  of  one  task  for  those  of  another 
task.  The  illustration  in  Figure  2 indicates  that  task  8 
will  be  replaced  by  task  9 upon  completion  of  task  2 (the 
symbol  identifies  a task  modification  operation) . 

Task  and  resource  clearing  involve  the  interruption 
(clearing)  of  a task  in  progress  when  another  task  is  com- 
pleted. If  a clearing  operation  is  performed,  SAINT  allows 
the  number  of  predecessor  requirements  for  another  task  to 
be  reduced  by  one  (signaling) . As  indicated  previously,  the 
clearing  information  is  included  as  a part  of  the  description 
of  the  task  whose  completion  causes  the  clearing.  The  illustra- 
tion in  Figure  3 indicates  that  task  37  is  to  be  signaled  as 
a result  of  the  clearing  caused  by  the  completion  of  task  5 
(the  symbol  Q identifies  a task  signaling  operation  caused 
by  a task  or  resource  clearing) . 

SAINT  also  allows  the  number  of  predecessor  requirements 
for  a task  to  be  reduced  by  one  as  a result  of  a threshold 
crossing  detected  by  a monitor.  Figure  4 illustrates  a 
situation  in  which  task  20  will  be  signaled  when  monitor  10 
detects  a threshold  crossing  (the  symbol  I 1 identifies  a 
task  signaling  operation  caused  by  a threshold  crossing) . 


State  Variable  Definitions 

Although  the  SAINT  user  must  set  the  initial  values  of 
state  variables  in  subroutine  INTLC  and  code  their  defining 
equations  in  subroutine  STATE;  symbolism  is  available  to 
define  state  variables  on  the  network  model.  For  each  state 
variable  included  in  a SAINT  model,  four  pieces  of  infor- 
mation are  defined:  state  variable  number,  state  variable 
label,  defining  equation  in  STATE,  and  initial  value  in 
INTLC.  State  variable  information  is  depicted  on  the  network 
model  in  the  manner  shown  in  Figure  5. 


Monitors 

— 

t The  symbol  which  is  used  to  represent  a state  variable 

monitor  in  a SAINT  model  is  shown  in  Figure  6.  Its  design 
is  similar  to  that  provided  for  task  descriptions.  The 
right-hand  side  of  the  symbol  contains  the  monitor  description, 
and  is  divided  into  four  rows.  Each  row  represents  a unique 

,!  type  of  descriptive  information,  and  is  identified  by  one  of 

the  following  description  codes:  LABL,  MONF , MTAS , and  MSWT. 

By  using  the  description  codes,  only  the  information  neces- 
sary to  describe  a monitor  need  be  shown  on  the  monitor  symbol. 
Each  code  will  be  defined  and  examples  of  their  use  presented 
in  the  following  discussion. 
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Figure  2.  Task  Modification. 


Figure  3.  Task  Signaling  as  a Result  of  Task  or 
Resource  Clearing. 


Figure  4.  Task  Signaling  as  a Result  of  Threshold 
Crossing. 
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LABL 


The  code  LABL  identifies  a row  containing  the  monitor 
label.  For  example,  if  pressure  is  being  monitored,  then 
the  LABL  row  could  appear  as 


LABL 


PRESSURE 


MONF 


The  code  MONF  identifies  a row  containing  the  function 
to  be  used  in  locating  the  threshold  crossing.  For  example, 
suppose  that  the  value  of  SS(1)  is  being  monitored.  A 
threshold  crossing  occurs  when  the  value  of  SS(1)  falls 
below  the  value  of  3. 0*SS  (7) +4. 0 within  a tolerance  of  0.05. 
The  MONF  row  could  appear  as 


MONF 


SS(1)  4 3.0*SS (7)+4.0 (TOL= .05) 


or  as 


MONF 


SS(1)  CROSSING  BELOW  3. 0*SS (7) +4. 0 WITHIN  0.05 


MTAS 

The  code  MTAS  identifies  a row  containing  the  tasks  to 
be  signaled  as  a result  of  a threshold  crossing.  If  tasks 
27  and  41  are  to  be  signaled,  then  the  MTAS  row  could  appear 
as 


MTAS 


27,41 


MSWT 

The  code  MSWT  identifies  a row  containing  the  switch 
values  to  be  set  as  a result  of  a threshold  crossing.  If 
the  value  of  switch  3 is  to  be  set  to  27,  then  the  MSWT 
row  could  appear  as 
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I 


MSWT 

IS, 3=27 

MSWT 

SET  SWITCH  3 TO  27 

Example  of  Monitor  Description 

In  the  previous  discussion,  definitions  and  examples 
of  the  four  available  description  codes  were  presented. 

The  following  example  shows  how  the  individual  description 
rows  can  be  integrated  to  form  a complete  monitor  description. 


LABL 

SOLUTION  CONCENTRATION 

MONF 

SS  (3)  f SS(10)+17.2 ,TOL-0. 5 

15 

MTAS 

35 

MSWT 

(IS, 1-3) , (IS, 5=40) 

The  example  shown  above  is  the  symbol  describing 
monitor  15.  The  state  variable  being  monitored,  SS(3), 
is  the  concentration  of  a solution.  When  the  concentration 
increases  beyond  the  value  of  SS(10)+17.2,  with  a tolerance 
of  0.5,  a threshold  crossing  occurs.  This  causes  task  35 
to  be  signaled,  switch  1 to  be  set  to  3,  and  switch  5 to 
be  set  to  40. 

This  concludes  the  discussion  of  monitor  symbolism. 
Note  that  only  those  rows  necessary  to  completely  describe 
the  monitor  need  be  shown  on  the  monitor  symbol. 
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SECTION  III 


SAINT  DATA  INPUT  PROCEDURE 


The  SAINT  simulation  program  is  a FORTRAN  program  for 
simulating  SAINT  models.  The  user  of  SAINT  need  only  master 
the  procedures  for  translating  a model  into  data  input  cards 
in  order  to  obtain  an  analysis  of  the  model.  This  section 
specifies  the  procedures  involved  in  this  translation.  It 
provides  the  complete  specifications  for  preparing  the  input 
to  the  SAINT  program.  A list  of  the  SAINT  data  types  is 
presented  in  Table  5.  The  procedures  for  data  input  card 
preparation  are  described  next.  This  is  followed  by  a 
detailed  description  of  each  data  type  and  their  correspond- 
ing input  fields.  A condensed  version  of  the  data  type 
descriptions  is  included  at  the  end  of  this  section  for  the 
user  who  is  familiar  with  the  detailed  description. 


Data  Input  Card  Preparation 

All  SAINT  data  input  is  prepared  in  free  format.  Free 
format  input  permits  information  to  be  punched  without  card 
column  restrictions,  where  each  input  variable  is  defined  as 
a field  of  the  data  input  card.  The  features  of  SAINT  free 
form  input  include: 

1.  Card  ID  - Free  form  data  cards  are  uniquely  identi- 
fied by  an  ID  specified  in  the  first  field  of  the 
card.  Only  the  first  three  characters  on  this  ID 
are  significant.  Valid  card  types  are  identified 
in  Table  5. 

2.  Blanks  - Leading  blanks  and  blanks  imbedded  in 
numeric  fields  are  ignored. 

3.  Field  Termination  - All  fields  on  a card  except  the 
last  are  terminated  by  commas. 

4.  Continuation  Cards  - Continuation  cards  are  permitted. 
If  the  last  non-blank  character  of  a card  is  a com- 
ma, it  is  assumed  that  additional  fields  of  the  input 
record  are  contained  on  the  card  which  follows. 

Fields  may  not  be  split  between  cards.  A continua- 
tion card  contains  no  card  ID  and  the  additional 
fields  may  be  punched  anywhere  in  the  card.  Con- 
tinuation cards  may  themselves  be  continued.  However, 
an  input  record  may  not  exceed  50  fields. 

5.  Record  Termination  - An  asterisk  should  be  punched 
after  the  last  field  of  an  input  card.  If  no  asterisk 
is  present  and  the  last  non-blank  character  in  the 
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TABLE  5 


LIST  OF  SAINT  INPUT  DATA  TYPES 


General  Information 


GEN 

General  Information 

SGE 

State  variable  general  information 

POP 

Program  options 

OUT 

Output  options 

DIS 

Distribution  set  definitions 

SIM 

Used  when  multiple  networks  are  to  be  simulated 
to  mark  the  end  of  input  for  each  network  ex- 
cept the  last 

FIN 

Signals  end  (finish)  of  all  SAINT  input  cards 

User-Generated 

Statistics  and  Plots 

UBO 

User-generated  statistics  for  variables 
based  on  observation 

UTI 

User-generated  statistics  for  time-persistent 
variables 

UHI 

User-generated  histograms 

UPL 

User-generated  plot/table  characteristics 

UVA 

User-generated  plot/table  variable  information 

Initial  Status 

and  Labels 

IMO 

Initial  moderator  function  status  specification 

IRA 

Initial  resource  attribute  specification 

ISA 

Initial  system  attribute  specification 

LRE 

Labels  for  resources 

LSV 

Labels  for  state  variables 
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Task  Description 

TAS  Task  characteristics 

STA  Statistics  task  information 

UTC  Specification  of  user-defined  task  character- 

istics 

MOD  Specification  of  moderator  function  status 

ATA  Specification  of  attribute  assignment  infor- 

mation 

Task  Branching 


DET 

Deterministic  branching 

PRO 

Probabilistic  branching 

CFI 

Conditional-take  first  branching 

CAL 

Conditional-take  all  branching 

Effects  of  Task  Completions 

NMO 

Network  modifications 

DMO 

Distribution  set  modifications 

TCL 

Task  clearing 

RCL 

Resource  clearing 

SWI 

Switching  information 

REG 

Regulation  information 

State  Variable 

Monitors 

MON 

Monitor  characteristics 

MTA 

Monitor  actuated  task  signaling 

MSW 

Monitor  actuated  switching 
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State  Variable  Statistics  and  Plots 

SST  State  variable  statistics  information 

PLO  State  variable  plot/table  characteristics 

VAR  State  variable  plot/table  variable  informa- 

tion 
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card  is  not  a comma,  then  an  end  of  input  record  is 
assumed.  The  use  of  an  asterisk  is  preferred  since 
it  reduces  scanning  time. 

6.  Alphanumeric  Information  - Alphanumeric  data  may 
begin  with  a letter  or  a digit  and  may  contain  any 
combination  of  letters  and  digits.  In  any  alpha- 
numeric field,  characters  which  are  not  significant 
or  required  for  that  field  may  be  included  for 
clarity  and  documentation  purposes,  but  will  be  ig- 
nored in  processing.  Alphanumeric  fields  contain 
at  most  8 significant  characters. 

7.  Numeric  Information  - Any  numeric  information  may 
be  input  as  an  integer  or  as  a real  number. 

a.  If  an  integer  is  input  for  a field  specified 
as  real,  the  real  equivalent  of  the  integer 
value  is  used. 

b.  If  a real  is  input  for  a field  specified  as 
integer,  the  decimal  portion  of  the  real 
field  is  truncated  and  the  integer  equivalent 
of  the  truncated  result  is  used. 

Real  values  may  also  be  input  as  E-format  ("floating- 
point") numbers.  A valid  E-format  field  consists 
of  a number  followed  by  the  letter  E and  a one  or 
two  digit  power  of  10.  The  number  may  be  signed 
or  unsigned.  The  exponent  must  not  contain  a 
decimal  point  and  may  be  signed  or  unsigned. 

(Largest  valid  exponent  is  machine  dependent.) 
Integers  and  E-format  reals  are  not  interchangeable. 
A warning  message  will  be  generated  if  an  E-format 
real  is  submitted  for  a field  which  should  contain 
an  integer. 

Examples : 

+53.9E+10 
53.9E10 
53.9  E-10 
. 539E  -8 
1.E20 
-1.0E+20 

8.  Default  Values  - Default  values  are  defined  for 
all  nonessential  input  fields.  To  indicate  that 
the  default  value  is  to  be  used  for  a certain  field 
(or  that  a field  is  not, applicable  in  a given 
context) , the  user  should  do  one  of  the  following: 

a.  Omit  the  field  - Omission  of  a field  is 
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indicated  by  a conuna  or  by  blanks  followed 
by  a comma. 


< 


4 

b.  Skip  to  the  next  user-specified  input  field  - 
If  the  user  lists  the  number  (enclosed  in 

parentheses)  of  the  next  field  for  which  he  1 

wishes  to  specify  information,  all  intermedi- 
ate fields  will  be  bypassed  and  will  assume 
default  values.  For  example,  if  the  follow- 
ing card  is  input 

POP, 4, ,5, (8) MULTIPLE* 

these  assumptions  will  be  made: 

field  1 = POP 
field  2=4 

field  3 will  assume'  a default  value 
field  4=5 

fields  5 .through  7 will  assume  default 
values 
field  8 = M 

field  9 will  assume  a default  value 

c.  Terminate  the  card  before  giving  a value  for 
the  field.  For  instance,  in  the  preceding 
example  field  9 assumes  a default  value  since 
nine  fields  are  associated  with  card  type  POP 
and  only  eight  values  were  specified  on  the 
input  card. 

9.  Deck  Setup  - Cards  for  a single  network  may  be  input 
in  any  order  with  the  following  exceptions: 

a.  GEN,  SGE  (if  any) , POP,  OUT,  and  DIS  cards 
must  be  input  before  any  other  card  types. 

b.  VAR  cards  must  follow  their  associated  PLO 
card.  Similarly,  UVA  cards  must  follow  their 
associated  UPL  card. 

c.  A SIM  or  a FIN  card  must  be  the  last  input 
card  for  a network.  (A  SIM  card  is  used  if 
input  for  an  additional  network  follows.) 

Only  those  cards  which  will  be  used  for  a particular 
network  need  to  be  input.  For  example,  if  no  net- 
work modifications  or  task  clearings  are  included 
in  the  model,  no  NMO  or  TCL  cards  should  be  submitted. 

I | 
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SAINT  networks  can  be  sequentially  analyzed  by  stacking 
the  data  cards  for  each  network  one  after  another.  A SIM 
card  should  separate  the  data  cards  for  each  network. 


Detailed  Description  of  Data  T} 


Each  data  typt  will  not  be  presented.  For  each  field 
in  a data  card,  the  field  number,  the  nature  of  the  input 
(A=alphanumeric,  I=integer,  R=real) , the  associated  default 
values  (if  any) , and  a description  of  field  contents  will 
be  listed.  In  the  specification  of  alphanumberic  inputs, 
the  required  characters  for  each  code  are  underlined  in  the 
description  of  the  code  if  not  all  characters  shown  are 
required. 


GEN  - General  Information 


l 

i 

i 


Field  Value  Default  Description 


1 

2 

3 


A Card  identification  (GEN) . 

A SAINT  User  name  (maximum  of  8 characters) . 

I 1 Month. 


4 

5 

6 

7 

8 


9 

10 

11 


I 

I 

I 

I 

I 


1 

2001 

1 

1 

1 


I 71268659 

R 1. 

A Y 


Day. 

Year . 

Project  number. 

Number  of  iterations . 

Number  of  sink  tasks  that  must 
be  completed  for  network  to  be 
completed . 

Integer  random  number  seed . 

Scale  factor  to  be  used  in  con- 
junction with  function  type  SC. 

Print  suppression  key: 

Yes  = Print  echo  check. 

No  = Skip  printing  of  echo  check. 
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SGE  - State  Variable  General  Information 

This  data  type  is  input  only  if  state  variables  are 


1 

defined 

for  the 

simulation. 

i 

•1 

i 

Field 

Value 

Default 

Description 

I- 

1 

A 

Card  identification  (SGE) . 

2 

I 

0 

Number  of  equations  (largest 
index)  defining  state  variables 
written  in  terms  of  DD ( • ) . 
(NNEQD) 

3 

I 

0 

Number  of  equations  defining 
state  variables  written  in 
terms  of  SS(*).  (NNEQS ) 

4 

R 

( . 01*DTMAX) 

Minimum  step  size  permitted 
(DTMIN) . 

5 R (Min (DTSAV, 1.E20) ) Maximum  step  size  permitted 

(DTMAX) . 


6 R 1.E20  Communication  interval  for  re- 

cording values  on  plots/tables 
(DTSAV) 

>0  Time  between  communication 
points 

=0  Communication  to  occur  at 
each  accepted  update  point 
<0  Communication  only  at  event 
times 

7 R .00001  Absolute  local  truncation  error 

allowed  in  Runge-Kutta  inte- 
gration. (AAERR) 

8 R .00001  Relative  error  allowed  in  Runge- 

Kutta  integration.  (RRERR) 

| 

9 A W Key  to  indicate  severity  of 

error  when  accuracy  cannot  be 

maintained  by  the  Runge-Kutta 
integration  package,  either  in 
state  variable  updates  or 
searching  for  threshold  cros- 
sings. 

1 None  - Proceed  without  warning 

message 

Warning  - Proceed  with  warning 
message 

Fatal  - Fatal  error 
Accuracy  is  required  to  be  less 
than  or  equal  to  absolute  error  + 
(relative  error  *SS(I))  for  all  I. 
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POP  - Program  Options 


l Field  Value  Default  Description 

1 A Card  identification  (POP) . 

21  0 Number  of  resources  involved  in  the 

simulation  (largest  resource  number) . 

31  0 Number  of  resource  attributes  de- 

sired per  resource  packet. 

41  0 Number  of  information  attributes 

desired  per  information  packet. 

51  0 Number  of  system  attributes  desired. 

61  0 Number  of  moderator  functions  de- 

sired. 

7 A I Network  Modifications  (if  any) 

Interchange  - Interchange  modifica- 
tions desired 

Multiple  - Multiple  replacement 
modifications  desired 

8 A I Distribution  Set  Modifications  (if 

any) 

Interchange  - Interchange  modifica- 
tions desired 

Multiple  - Multiple  replacement 

modifications  desired. 

91  3 Ranking  procedure  for  the  file  of 

tasks  awaiting  scheduling 

1 Low  value  first  on  priority 

2 High  value  first  on  priority 

3 First-in,  First  out  (FIFO) 

4 Last-in,  Last-out  (LILO) 


I 

* 

' 


j 
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OUT  - Output  Options 


t 

i 


Field  Value  Default 

1 A 

2 1 0 

3 I value  in  field  2 

4 1 0 

5 I value  in  field  4 

r 

6 1 0 

7 I value  in  field  6 

8 I 0 

9 I value  in  field  8 

10  I 0 

11  I value  in  field  10 

12  I 0 


Description 

Card  identification  (OUT) . 

Iteration  number  for  which  the 
detailed  output  should 
begin . 

Iteration  number  for  which  the 
detailed  iteration  output  should 
terminate . 

Iteration  number  for  which  the 
resource  utilization  summary 
output  should  begin. 

Iteration  number  for  which  the 
resource  utilization  summary 
output  should  terminate. 

Iteration  number  for  which  the 
statistics  task  summary  output 
should  begin. 

Iteration  number  for  which  the 
statistics  task  summary  output 
should  terminate. 

Iteration  number  for  which  ini- 
tial and  final  state  variable 
value  outputs  should  begin. 

Iteration  number  for  which  ini- 
tial and  final  state  variable 
value  outputs  should  terminate. 

Iteration  number  for  which  state 
variable  statistical  output 
should  begin. 

Iteration  number  for  which  state 
variable  statistical  output 
should  terminate. 

Iteration  number  for  which  the 
preparation  of  state  variable 
plots/tables  should  begin. 


L 
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Field  Value  Default  Description 

13  I value  in  field  12  Iteration  number  for  which  the 

preparation  of  state  variable 
plots/tables  should  terminate. 

14  A Y Print  suppression  key: 

Yes  = Print  resource  utili- 
zation summary  report. 

No  = Do  not  print  report. 

15  A Y Print  suppression  key: 

Yes  = Print  statistics  task  sum- 
mary report. 

No  = Do  not  print  report. 

16  A N Print  suppression  key: 

Yes  = Print  histograms  of  statis- 
tics tasks  values  from 
iteration  1. 

No  = Do  not  print  histograms. 

17  A N Print  suppression  key: 

Yes  = Print  histograms  of  statis- 
tics tasks  values  from 
summary  report. 

No  = Do  not  print  histograms. 


DIS  - Distribution  Set  Definitions 


All  distribution  sets  required  for  task  performance  times 
and  attribute  assignments  are  defined  by  these  input  cards. 

One  card  is  required  for  each  different  distribution  set 
number . 


Field  Value  Default 


Description 


1 A 


Card  identification  (DIS) . 


2 I 


Distribution  set  number. 


3 A CO 


Distribution  type  (maximum  of  2 
characters) . 


4-7  R 


0.  Parameter  values  for  the  distri- 

tion  specified  in  Field  3 as 
defined  by  the  following  input 
description . 


Available  SAINT  Distributions 

In  SAINT,  sample  values  can  be  obtained  from  any  of 
the  following  11  distributions: 


BE 

Beta 

BP 

Beta  fitted  to  3 

values  as  in  PERT 

CO 

Constant 

ER 

Erlang  (includes 

Exponential) 

GA 

Gamma 

LO 

Lognormal 

NO 

Normal 

PO 

Poisson 

TR 

Triangular 

UN 

Uniform 

WE 

Weibull 

Parameters  Required  for  SAINT  Distributions 

In  SAINT,  samples  are  obtained  from  the  distributions 
such  that  if  a sample  is  less  than  the  minimum  value,  the 
sample  value  is  assigned  the  minimum  value.  Similarly,  if 
the  sample  is  greater  than  the  maximum  value,  the  sample  value 
is  assigned  the  maximum  value.  This  is  not  sampling  from  a 
truncated  distribution,  but  sampling  from  a distribution  with 
a given  probability  of  obtaining  the  minimum  and  maximum 
values . 

The  parameters  required  to  sample  from  the  distributions 
available  in  SAINT  are  described  below.  Fields  1,  2,  and  3 
are  the  same  for  all  distributions. 

For  distribution  type  CO  (Constant) : 

Field  4 The  constant  time 

For  distribution  type  NO  (Normal) ; LO  (Lognormal) ; BE 

(Beta) ; and  GA  (Gamma) : 


Field  4 
Field  5 
Field  6 
Field  7 


The  mean  value 

The  minimum  value 

The  maximum  value 

The  standard  deviation  value 
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For  distribution  type  UN  (Uniform) : 


Field  4 
Field  5 
Field  6 
Field  7 


Not  used 

The  minimum  value 
The  maximum  value 
Not  used 


For  distribution  type  ER  (Erlang) ; 

Field  4 The  mean  time  for  the  Erlang  variable  divided  by  the 
value  given  to  Field  7 
Field  5 The  minimum  value 
Field  6 The  maximum  value 

Field  7 The  number  of  exponential  deviates  to  be  included  in 
the  sample  obtained  from  the  Erlang  distribution 

If  Field  7 is  set  equal  to  1 , an  exponential  deviate  will  be 
obtained  from  distribution  type  ER. 

For  distribution  type  PO  (Poisson) : 


Field  4 
Field  5 
Field  6 
Field  7 


The  mean  minus  the  minimum  value 
The  minimum  value 
The  maximum  value 
Not  used 


Care  is  required  when  using  the  Poisson  since  it  is  not 
usually  used  to  represent  an  interval  of  time. 

For  distribution  type  BP  (Beta  fitted  to  3 values  as 
in  PERT) ; TR  (Triangular) : 

Field  4 The  most  likely  value,  m 

Field  5 The  optimistic  (smallest)  value,  a 

Field  6 The  pessimistic  (largest)  value,  b 

Field  7 Not  used 

For  distribution  type  WE  (Weibull) ; 


Field  4 a (a  > 0) 

Field  5 The  minimum  value 
Field  6 The  maximum  value 
Field  7 3 (3  > 0 ) 

where : 

fx(x)  = ctex6-1exp[-ax0]  , and 
Fx(x)  = 1 - exp [-ax®] 
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UBO  - User-Generated  Statistics  for  Variables  Based 
on  Observation. 

This  card  type  is  required  for  user-generated  statistics 
for  variables  based  on  observation. 


Field  Value  Default 


Description 


1 A 


Card  identification  (UBO) . 


2 

3 


I Statistic  number  (used  as  an 

argument  to  subroutine  UCLCT) . 

A " " Statistic  label  (maximum  of  8 

characters)  . 


Fields  2 and  3 may  be  repeated  so  that  up  to  24  statistics 
may  be  specified  in  a single  input  record.  Additional  UBO 
cards  may  also  be  used. 
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UTI  - User-Generated  Statistics  for  Time  Persistent  Variables 

This  card  type  is  required  for  user-generated  statistics 
for  tine-persistent  variables. 


Field  T?alue  Default 

1 A 

2 I 


Description 

Card  identification  (UTI) . 

Statistic  number  (used  as  an  argu- 
ment to  subroutine  UTMST  OR  UTMSA) . 


3 A 


Statistic  label  (maximum  of  8 
characters) . 


4 R 


0.  Initial  value  of  the  variable  to 

be  observed . 


Fields  2-4  may  be  repeated  so  that  up  to  16  statistics  may 
be  specified  in  a single  input  record.  Additional  UTI  cards 
may  also  be  used. 
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UHI  - User-Generated  Histograms 

This  card  type  is  required  for  user-generated  histograms. 


Field  Value  Default 

1 A 

2 I 

3 A " " 


Description 

Card  identification  (UHI) . 

Histogram  number  (used  as  an  argu 
ment  to  subroutine  UHIST) . 

Histogram  label  (maximum  of  8 cha 
acters) . 


4 I 

5 R 

6 R 


25  Number  of  cells  in  histogram. 

0.  Upper  limit  of  first  cell  of 
histogram. 

1.  Width  of  each  cell  of  histogram. 


Fields  2-6  may  be  repeated  so  that  up  to  9 histograms 
may  be  specified  in  a single  input  record.  Additional  UHI 
cards  may  also  be  used. 


4g 


User-Generated  Plots/Tables 


User-generated  plot/table  information  is  contained  on 
two  types  of  data  cards.  The  first  card  (UPL  card)  contains 
information  on  the  plot/table.  The  second  card  (UVA  card) 
contains  information  on  the  variables  to  be  plotted/tabled. 

One  or  more  UVA  cards  may  be  input  to  describe  the  variables  to 
be  included  in  the  plot/table  described  by  UPL  card.  One  UPL 
card  and  its  associated  UVA  cards  are  required  for  each 
user-generated  plot/table. 
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UPL  - User-Generated  Plot/Table  Characteristics 

Field  Value  Default  Description 

1 A Card  identification  (UPL)  . 

2 I Plot/table  number  (used  as  an 

argument  to  subroutine  UPLOT) . 

3 A "TIME"  Independent  axis  label  (maximum 

of  8 characters)  . 

4 A 0 Storage  medium  to  be  used  for 


plot/table  values; 

J-  0 Peripheral  storage  unit  num- 
ber on  which  plot/table  infor- 
mation is  to  be  written  (re- 
quired if  multiple  plots/tables 
are  desired) . 

= 0 Plot/table  information  to  be 
stored  in  core  (UPSET(*)). 

Only  1 plot/table  can  be  re- 
quested and  Field  2 must  be 
set  to  1 if  core  is  used. 


P Plot/table  option 

Quick  - Quick  Plot 
Plot  - Plot  only 
Table  - Table  only 
Both  - Plot  and  table. 

5.  Increment  of  the  independent 

variable  between  successive  plot 
points . 


UVA  - User-Generated  Plot/Table  Variable  Information 


Field  Value  Default  Description 


1 A Card  identification  (UVA) • 

2 I Plot/Table  Number  (same  as  Field 

2 of  associated  UPL  card) . 

3 I Variable  number. 

4 I value  in  field  3 Plot  symbol  (maximum  of  1 

character) . 

5 A " " Label  associated  with  the  varia- 

ble being  plotted/tabled  (maxi- 
mum of  8 characters) . 

6 A M Key  for  specifying  the  lower 


limit  of  the  scale  to  be  used  for 

the  variable 

Minimum  - Use  minimum  value  ob- 
served during  the 
simulation. 

Value  - Use  value  in  Field  8. 

Rounded  - Use  the  largest  multiple 
of  the  value  specified 
in  Field  8 that  is  less 
than  or  equal  to  the 
minimum  value  observed. 

7 A M Key  for  specifying  the  upper  limit 

of  the  scales  to  be  used  for  this 

variable 

Maximum  - Use  maximum  value  ob- 
served during  the  simu- 
lation. 

Value  - Use  value  in  Field  9. 

Rounded  - Use  the  smallest  multiple 
of  the  value  specified  in 
Field  9 that  is  greater 
than  or  equal  to  the  max- 
imum value  observed. 

8 R 0.  Value  associated  with  the  lower 

limit  of  the  plot  ordinate  (see 

Field  6) . 
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Field  Value  Default  Description 

9 R 0.  Value  associated  with  the  upper 

limit  of  the  plot  ordinate  (see 
Field  7) . 

Fields  3-9  may  be  repeated  so  that  up  to  6 variables  may 
be  described  on  a single  data  card.  Additional  UVA  cards 
may  also  be  used  to  describe  additional  variables. 
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IMP  - Initial  Moderator  Function  Status  Specification 


Field  Value  Default 

1 A 

2 I 


Description 

Card  identification  (IMO) . 
Moderator  function  number. 


3 A I Initial  moderator  function  status 

Inactive  - Moderator  function 
inactive 

Active  - Moderator  function  active. 


Fields  2 and  3 may  be  repeated  so  that  the  initial  status 
of  up  to  24  moderator  functions  may  be  specified  on  a single 
data  card.  Additional  IMO  cards  may  also  be  used  to  initial- 
ize additional  moderator  functions. 


If  the  initial  status  of  a moderator  function  is  not  speci- 
fied by  this  data  type,  it  is  assumed  to  be  inactive. 
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IRA  - Initial  Resource  Attribute  Specification 


This  card  is  used  to  specify  the  initial  resource 
attribute  assignments.  All  assignments  specified  on  a single 
data  card  are  assigned  to  the  resource  whose  number  is 
specified  in  Field  2 of  that  card. 


Field  Value  Default  Description 

1 A Card  identification  (IRA)  . 

2 I Resource  number  associated  with 

all  assignments  specified  on  this 
card . 

3 I Resource  attribute  number  to  which 

the  assignment  specified  in  Fields 
4 and  5 is  to  be  made. 

4 A SC  The  function  to  be  used  in  con- 


junction with  the  parameter  specifi- 
cation (Field  5)  in  making  the 
assignment.  The  allowable  functions 
are: 

DS  Value  sampled  from  the  distrib- 
ution set  specified  as  the 
parameter  specification. 

SC  Constant  equal  to  the  parameter 
specification  divided  by  the 
scale  factor  (Field  21  of  GEN 
card) . 

UF  User-written  function  (used 
in  conjunction  with  function 
USERF  (I)  where  I is  the  para- 
meter specification) . 

5 I 0 Parameter  specif ication  to  be  used 

in  making  the  assignment. 

Fields  3-5  may  be  repeated  so  that  up  to  10  initial  resource 
attribute  assignments  can  be  made  on  a single  data  card. 

Additional  IRA  cards  may  also  be  used  to  make  additional 
initial  resource  attribute  specifications. 
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ISA  - Initial  System  Attribute  Specification 


Field  Value  Default  Description 

1 A Card  identification  (ISA). 

2 I System  attribute  number  to  which 

the  assignment  specified  in  Fields 
3 and  4 is  to  be  made. 

3 A SC  The  function  to  be  used  in  con- 


junction with  the  parameter 
specification  (Field  3)  in  making 
the  assignment.  The  allowable 
functions  are: 

DS  Value  sampled  from  the  distri- 
bution set  specified  as  the 
parameter  specification 

SC  Constant  equal  to  the  para- 
meter specification  divided  by 
the  scale  factor  (Field  12 
of  GEN  card) 

UF  User-written  function  (used 
in  conjunction  with  function 
USERF(I),  where  I is  the 
parameter  specification) . 

41  0 Parameter  specification  to  be  used 

in  making  the  assignment. 

Fields  2-4  may  be  repeated  so  that  up  to  10  initial  system 
attribute  assignments  can  be  made  on  a single  data  card. 
Additional  ISA  cards  may  also  be  used. 
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LRE  - Labels  for  Resources 


This  card  type  is  required  to  assign  labels  to  resources. 


Number  of  the  resource  to  be 
assigned  a label. 


3 A " " Alphanumeric  label  for  the  re- 

source specified  in  Field  2 (max- 
imum of  8 characters) . 

Fields  2 and  3 may  be  repeated  so  that  a total  of  10  resource 
labels  can  be  specified  in  a single  input  record.  Additional 
LRE  cards  may  also  be  used. 
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LSV  - Labels  for  State  Variables 


This  card  type  is  required  to  assign  labels  to  state 
variables . 


Field  Value 


Default 


Description 


Card  identification  (LSV) . 


Number  of  the  state  variable  to 
be  assigned  a label. 

Alphanumeric  label  for  the  state 
variable  specified  in  Field  2 
(maximum  of  8 characters) . 


Fields  2 and  3 may  be  repeated  so  that  a total  of  10  state 
variable  labels  can  be  specified  in  a single  input  record. 
Additional  LSV  cards  may  also  be  used. 


'V*  — w~ 


Task  Definitions 


Information  about  a task  is  contained  on  up  to  six 
data  cards.  The  first  card  (TAS  card)  contains  information 
about  the  characteristics  of  the  task.  The  second  card 
(STA  card)  contains  information  concerning  marking  and  the 
statistics  to  be  collected  at  the  task.  This  card  is  only 
used  if  marking  is  to  be  performed  or  statistics  are  to  be 
collected  at  the  task.  The  third  card  (UTC  card)  contains 
the  values  of  user-defined  task  characteristics.  This  card 
is  only  used  if  the  number  of  user-defined  task  characteris- 
tics is  greater  than  zero.  The  fourth  card  (MOD  card)  con- 
tains moderator  function  status  information.  This  card  is 
only  used  if  any  status  changes  are  to  be  made.  The  fifth 
card  (ATA  card)  contains  attribute  assignment  information. 
This  card  is  only  used  if  attribute  assignments  are  to  be 
made.  The  sixth  card  contains  information  about  the  task's 
branching  and  successor  tasks.  A branching  card  is  only 
used  if  branching  is  performed  from  the  task.  The  following 
branching  types  are  allowed: 

deterministic  (DET  card) 
probabilistic  (PRO  card) 
conditional-take  first  (CFI  card) 
conditional-take  all  (CAL  card) 
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TAS 


Task  Characteristics 


Field  Value  Default  Description 

1 A Card  identification  (TAS) . 

2 I The  number  of  the  task  whose 

characteristics  are  given  on  this 
card. 

3 A " " Task  Label  (maximum  of  8 charac- 

ters) . 

4 I 0 if  source  task.  The  number  of  predecessor  com- 

1 otherwise  pletions  required  to  release  the 

task  for  the  first  time. 

5 I 9999  The  number  of  predecessor  com- 

pletions required  for  all  subse- 
quent releases  of  the  task. 

6 A SC  The  function  to  be  used  in  con- 

junction with  the  parameter 
specification  in  Field  7 in  ob- 
taining the  task  performance 
time.  The  allowable  functions  are: 
DS  Value  sampled  from  the  dis- 
tribution set  specified  as 
the  parameter  specification 
SC  Constant  equal  to  the  para- 
meter specification  divided 
by  the  scale  factor  (Field 
12  of  GEN  Card) 

UF  User-written  function  (used 
in  conjunction  with  function 
USERF  (I) , where  I is  the 
parameter  specification) 

IA  Value  taken  from  the  informa- 
tion attribute  specified  as 
the  parameter  specification 
RA  Value  taken  from  the  resource 
attribute  specified  as  the 
parameter  specification 
SA  Value  taken  from  the  system 
attribute  specified  as  the 
parameter  specification. 

71  0 Parameter  specification  to  be 

used  in  conjunction  with  Field  6 
in  obtaining  a value  for  the  task 
performance  time. 
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Field  Value  Default  Description 

81  0 Resource  number  to  be  used  if 

function  RA  was  selected  in 
Field  6. 

9 R 0.  Task  priority. 

10  A NS  Special  task  characteristics 

SOurce  - Source  task 

Sink  - Sink  task 

NS  - No  special  characteristic 

is  associated  with  the  task. 

11  A N Indicator  that  different  prede- 

cessor completions  are  required 
to  release  the  task. 

Yes  - Different  predecessor  com- 
pletions required 

No  - No  requirement  for  different 
predecessor  completions. 

12  A L Information  choice  mechanism 

decision  mode 

First  - Hold  packet  arriving  with 
first  requirement 
Last  - Hold  packet  arriving  with 
last  requirement 

Big  - Hold  packet  with  the  largest 
value  in  attribute  specified 
in  Field  13 

Small  - Hold  packet  with  the  smal- 
lest value  in  attribute 
specified  in  Field  13. 

13  I 0 Information  attribute  to  be  used 

for  comparison  if  mode  Big  or 
Small  is  selected  in  Field  12. 

14  R 0.  Task  completion  precedence. 

15  A A Resource  Requirement  Code 

And  - All  resources  specified 
(if  any)  required  for 
performance 

Or  - One  of  the  resources  speci- 
fied required  for  performance. 

16-20  I Resources  associated  with  this  task 

(must  appear  in  ascending  numerical 
order;  maximum  of  five  resources 
permitted) . 
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STA  - Statistics  Task  Information 

This  card  is  required  only  if  marking  is  to  be  performed 
or  statistics  are  to  be  collected  at  this  task.  Only  one  STA 
card  per  task  is  allowed. 


Field  Value  Default  Description 

1 A Card  identification  (STA)  . 

2 I Task  number. 

3 A N Indicator  that  marking  is  to  be 

performed  at  this  task: 

M - marking 
N - no  marking. 

4 A COM  Time  of  marking: 


FPC  - first  predecessor  completion 

REL  - release  of  task 

STA  - start  of  task 

COM  - completion  of  task. 

5 A NO  Statistics  type: 


FIR  - 

first 

ALL  - 

all 

BET  - 

between 

INT  - 

interval 

NUM  - 

number 

NO  - 

no  statistics. 

6 A COM  Time  of  statistics  collection 

REL  - release  of  task 
STA  - start  of  task 
COM  - completion  of  task 
CLR  - clearing  of  task. 

7 I 25  Number  of  cells  for  the  histogram. 


8 

9 


R 0. 

R 1. 


Upper  limit  of  the  1st  cell  of  the 
histogram. 

Cell  width. 
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UTC  - Specification  of  User-Defined  Task  Characteristics 

This  card  is  required  only  if  there  are  user-defined 
task  characteristics  for  this  task.  Only  one  UTC  card  per 
task  is  allowed. 


Field  Value  Default  Description 

1 A Card  identification  (UTC) 

2 I Task  number. 

3-27  R 0.  The  values  of  the  user-defined  task 

characteristics  associated  with 
this  task. 


The  value  of  each  user-defined  task  characteristic  is  labeled 
according  to  the  field  in  which  is  appears.  In  other  words, 
the  value  of  user-defined  task  characteristic  I is  specified 
in  Field  3,  while  the  value  of  user-defined  task  characteris- 
tic 25  is  specified  in  Field  27.  Up  to  25  user-defined  task 
characteristics  are  allowed  for  each  task. 
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MOD  - Specification  of  Moderator  Function  Status 


l 

j 


This  card  is  required  only  if  an  update  in  the  status 
of  any  moderator  function  is  to  be  made  at  this  task.  Only 
one  MOD  card  per  task  is  allowed. 


Field  Value  Default  Description 

1 A Card  identification  (MOD) . 

2 I Task  number. 

3 I Moderator  function  number  for  which 

the  status  will  be  updated. 

4 A D Status  of  the  moderator  function 


specified  in  Field  3 
Deactivate  - Deactivate  moderator 
function 

Activate  - Activate  moderator 
function. 

5 A T Duration  of  the  status  update  speci- 

fied in  Field  4 

Task  - For  the  task  specified  in 
Field  2 only. 

Perm  - Permanently:  until  end  of 
simulation  or  next  status 
update . 

Fields  3-5  may  be  repeated  so  that  the  status  of  up  to 
10  moderator  functions  may  be  updated  at  a single  task. 


ij 

! 

I 
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ATA  - Specification  of  Attribute  Assignment  Information 

This  card  is  required  only  if  attribute  assignments  are 
to  be  made  at  this  task.  Only  one  ATA  card  per  task  is  allowed. 


Field  Value  Default  Description 

1 A Card  identification  (ATA) . 

2 I Task  number. 

3 A COM  Attribute  assignment  point 


REL  - at  task  release 
STA  - at  task  start 
COM  - at  task  completion. 

4 A IA  Type  of  attribute  assignment 

SA  - System  attribute  assignment 
IA  - Information  attribute  assign- 
ment 

RA  - Resource  attribute  assignment. 

51  0 Resource  number  if  RA  specified  in 

Field  4. 


61  0 The  attribute  number  to  which  the 

assignment  is  to  be  made. 

7 A SC  The  function  to  be  used  in  conjunc- 

tion with  the  parameter  specification 
(Field  8)  in  making  the  assignment. 
The  allowable  functions  are: 

DS  Value  samples  from  the  distri- 
bution set  specified  as  the 
parameter  specification 

SC  Constant  equal  to  the  parameter 
specification  divided  by  the 
scale  factor  (Field  12  of  GEN 
card) 

UF  User  written  function  (used  in 
conjuncticn  with  function 
USERF(I),  where  I is  the  para- 
meter specification) . 

< 

81  0 The  parameter  specification  to  be 

used  in  making  the  assignment. 

Fields  4-8  may  be  repeated  so  that  up  to  6 attribute 
assignments  can  be  made  at  a single  task. 

I 
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Successor  Tasks 


: 

i 

i 

I 


A successor  task  card  is  required  only  if  branching  is 
to  be  performed  following  the  completion  of  this  task.  Only 
one  successor  task  card  per  task  is  allowed. 


1 


PET  - DETERMINISTIC  Branching 


i 

1 

Field 

Value  Default 

Description 

1 

A 

Card  identification  (DET) . 

2 

I 

Task  number. 

3 

I 

Successor  task  to  task  specified  in 
Field  2. 

Field 

3 may  be  repeated 

so  that  up  to  20  successor  tasks 

may  be 

specified . 

! 

I 

i 


I 

-I 


.i 


i 
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PRO  - PROBABILISTIC  Branching 


Field  Value  Default  Description 

1 A Card  identification  (PRO) . 

2 I Task  number. 

3 A NO  For  attribute-based  probabilistic 


branching,  the  attribute  type  to  be 
used 

SA  - System  attribute. 

IA  - Information  attribute. 

RA  - Resource  attribute. 

NO  - Not  attribute-based  probabilistic 
branching. 


41  0 Resource  number  if  RA  is  specified 

in  Field  3. 

5 I Successor  task  number. 

6 R Probability  of  selecting  the  task  in 

Field  5 as  the  successor  to  the  task 
in  Field  2 (0  < probability  < 1) . For 
attribute-based  probabilistic  branching, 
the  attribute  number  from  which  the  prob- 
ability is  to  be  taken. 


Fields  5 and  6 may  be  repeated  so  that  up  to  10  successor 
tasks  may  be  specified.  The  first  branch  specified  (Fields 
5 and  6)  is  identified  as  the  first  branch  from  the  task 
specified  in  Field  2. 
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CFI  - CONDITIONAL  Branching  - Take  FIRST  branch  for  which 
the  specified  condition  is  satisfied. 


Field  Value  Default  Description 

1 A Card  identification  (CFI) . 

2 I Task  number. 

3 I Successor  task  number. 

4 A NO  Code  signifying  the  type  of  condition 

to  be  met  for  selecting  task  in  Field 

3 as  the  successor  to  the  task  given 

in  Field  2 according  to  the  value 

specified  in  Field  5. 

TVC-The  task  specified  as  value  of 
Field  5 has  been  completed. 

TVN-The  task  specified  as  value  of 
Field  5 has  not  been  completed. 

TLV-Time  of  completion  of  the  task  in 
Field  2 is  less  than  or  equal  to 
the  time  specified  in  Field  5. 

TGV-Time  of  completion  of  the  task  in 
Field  2 is  greater  than  the  time 
specified  as  value  of  Field  5. 

ALV-The  value  of  the  attribute  speci- 
fied in  Field  6 is  less  than  or 
equal  to  the  value  specified  in 
Field  5. 

AGV-The  value  of  the  attribute  speci- 
fied in  Field  6 is  greater  than 
the  value  specified  in  Field  5. 

TAC-The  task  whose  number  is  found  in 
the  attribute  specified  in  Field  5 
has  been  completed. 

TAN -The  task  whose  number  is  found  in 
the  attribute  specified  in  Field 
5 has  not  been  completed . 

TLA-Time  of  completion  of  the  task  in 
Field  2 is  less  than  or  equal  to 
the  time  found  in  the  attribute 
specified  in  Field  5. 

TGA-Time  of  completion  of  the  task 
! in  Field  2 is  greater  than  the 

time  found  in  the  attribute 
specified  in  Field  5. 

ALA-The  value  found  in  the  attribute 
specified  in  Field  6 is  less  than 
or  equal  to  the  value  found  in 
the  attribute  specified  in  Field  5. 


Field  Value  Default  Description 

AGA-The  value  found  in  the  attribute 
specified  in  Field  6 is  greater 
than  the  value  found  in  the  attri- 
bute specified  in  Field  5- 
Mo  -No  condition  required;  task  speci- 
fied in  Field  3 is  selected  as 
successor  (only  for  last  condition 
specified) . 

5 R 0.  Value  associated  with  the  condition 

or  the  attribute  which  contains  the 
value • 

610  Attribute  to  be  used  in  a comparison 

of  two  attribute  values.  Otherwise, 
this  field  should  be  left  blank. 

If  attribute  values  are  required  for 
the  condition  specified  in  Field  4, 
the  type  of  attribute  to  be  used 
SA-System  attribute. 

IA-Information  attribute. 

RA-Resource  attribute. 

NO-No  attribute  values  required. 

810  Resource  number  if  RA  specified  in 

Field  7. 

Fields  3-8  may  be  repeated  so  that  up  to  5 successor  tasks 
may  be  specified.  If  a sixth  successor  is  specified,  the 
branch  is  taken  unconditionally. 


7 A IA,  if  attri- 

bute 
required 
NO,  other 
wise 


CAL  - CONDITIONAL  Branching  - Take  ALL  branches  for  which 
the  specified  condition  is  satisfied.  Input  speci- 
fication is  the  same  as  that  specified  directly 
above  for  Conditional  Branching  - Take  First. 





71 


NMO  - Network  Modifications 

Only  required  if  network  modifications  exist.  Only 
one  NMO  card  per  task  is  allowed. 


Field  Value  Default  Description 


1 A Card  identification  (NMO)  . 

2 I Task  number. 

3 I The  number  of  the  task  to  be  re- 

placed when  the  task  given  in  Field 
2 is  completed. 

4 I The  number  of  the  task  to  be  in- 

serted into  the  network  in  place  of 
the  task  specified  in  preceding 

i field  when  the  task  in  Field  2 is 

completed. 


Fields  3 and  4 may  be  repeated  so  that  a total  of  10  replace- 
ments may  be  made  based  on  one  task  completion. 


i 


I 

: 


i 


: 
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DMO  - Distribution  Set  Modification 

Only  required  if  distribution  set  modifications  exist. 
Only  one  DMO  card  per  task  is  allowed. 


Field  Value  Default  Description 


1 A Card  Identification  (DMO) . 

2 I Task  number. 

3 I The  distribution  set  number  to  be 

replaced  when  the  task  given  in 
Field  2 is  completed. 

4 I The  distribution  set  number  to  be 

inserted  in  place  of  the  distribution 
set  specified  in  preceding  field  when 
the  task  in  Field  2 is  completed. 


Fields  3 and  4 may  be  repeated  so  that  a total  of  10  replace- 
ments may  be  made  based  on  one  task  completion. 
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TCL  - Task  Clearing 

Only  required  if  clearing  of  tasks  is  desired.  Only 
one  TCL  card  per  task  is  allowed. 


Field  Value  Default  Description 

1 A Card  identification  (TCL) . 

2 I Task  number. 

3 I Task  in  progress  to  be  halted 

(cleared)  when  the  task  specified 
in  Field  2 is  completed. 

41  0 Task  to  be  signaled  when  task  in 

preceding  field  is  cleared.  A 
zero  in  this  field  indicates  no  task 
to  be  signaled. 


Fields  3 and  4 may  be  repeated  so  that  a total  of  10  tasks 
may  be  cleared  based  on  one  task  completion. 
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RCL  - Resource  Clearing 

Only  required  if  clearing  at  resources  is  desired. 
Only  one  RCL  card  per  task  is  allowed. 


Field  Value  Default  Description 

1 A Card  identification  (RCL) . 

2 I Task  number. 

3 I Resource  to  be  cleared.  If  resource 

is  not  busy,  no  clearing  is  performed. 

4 I 0 Task  to  be  signaled  when  resource 

in  preceding  field  is  cleared.  A 
zero  in  this  field  indicates  no  task 
to  be  signaled. 


Fields  3 and  4 may  be  repeated  so  that  a total  of  10  resources 
may  be  cleared  based  on  one  task  completion. 


SWI  - Switching  Information 


This  data  type  is  necessary  only  if  switches  are  to  be 
set  as  a result  of  task  completion.  One  card  of  this  type  is 
required  for  each  task  causing  switching.  Only  one  SWI  card 
per  task  is  allowed. 


Field  Value 


1 

2 


A 

I 


Default 


Description 

Card  identification  (SWI) . 

Task  whose  completion  will  cause 
the  switching  action  detailed  on 
this  card. 


Switch  number  affected. 


41  0 Switch  value  given  to  switch  number 

in  preceding  field  when  task  in 
Field  2 is  completed. 


Fields  3 and  4 may  be  repeated  so  that  up  to  10  switches  may 
be  affected  based  on  one  task  completion. 
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REG  - Regulation  Information 

One  card  of  this  type  is  required  for  each  task  causing 
regulation  of  state  variables.  Only  one  REG  card  per  task 
is  allowed. 


Field  Value  Default  Description 

1 A Card  identification  (REG) . 

2 I Task  number  that  regulates,  in  the 

prescribed  manner,  the  state  variable 
specified  in  Field  3. 

3 I Index  of  SS  ( • ) variable  to  be  regu- 

lated upon  the  completion  of  the 
task  specified  in  Field  2. 

410  The  index  of  the  SS ( • ) variable  in- 


volved in  determining  the  regulation 
value  (if  this  input  is  positive) . 

The  index  of  the  DD  ( • ) variable  in- 
volved (if  this  input  is  negative) . 
Zero  if  no  SS  or  DD  variable  involved. 

5 R 1.  Multiplicative  constant  (CMULT) 

applied  to  the  variable  designated 
in  Field  4 in  determining  the 
regulation  value. 

6 R 0.  A constant  value  added  to  the  product 

of  the  values  specified  in  Fields 
4 and  5 in  determining  the  regula- 
tion value. 


7 A E.  Indicator  specifying  how  the  above 

determined  regulation  value  will 
affect  the  variable  designated  in 
Field  2 

Increase-Increase  by  function  value. 
Equal-Regulate  to  function  value . 
Decrease-Decrease  by  function  value. 

Fields  3-7  may  be  repeated  so  that  up  to  2 regulations  may 
be  made  based  on  one  task  completion. 
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State  Variable  Monitor  Information 


MON  - Monitor  Characteristics 


Field  Value  Default  Description 


1 A Card  identification  (MON) . 

2 I Monitor  number. 

3 A " " Monitor  label  (maximum  of  8 

characters)  . 

4 I Index  of  the  variable  to  be  monitored 


> 0 SS  ( •)  variable . 

= o Error. 

< 0 DD  (•)  variable. 

1 0 Index  of  the  variable  used  in  com- 

puting the  threshold 

> 0 SS  ( • ) variable . 

= o None . 

< 0 DD ( • ) variable. 

6 R 1.  Multiplicative  constant  (CMULT) 

to  be  used  in  the  threshold  function: 
CADD  + CMULT  * value  of  variable  in 
Field  5. 

7 R 0.  Additive  constant  (CADD)  to  be  used 

in  the  threshold  function: 

CADD  + CMULT  * value  of  variable  in 
Field  5. 

8 A B Direction  of  crossing  to  be  observed 

Positive-Positive  direction. 

Both-Both  positive  and  negative 
directions . 

Negative-Negative  direction. 

9 R 0 . The  tolerance  within  which  the 

crossing  is  to  be  detected. 
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MTA  - Monitor  Actuated  Task  Signaling 

This  data  card  is  used  only  if  tasks  are  to  be  signaled 
as  a result  of  a threshold  crossing.  Only  one  MTA  card  per 
monitor  is  allowed. 


Field  Value  Default  Description 

1 A Card  identification  (MTA) . 

2 I Monitor  number. 

3 I Task  to  be  signaled  when  a thres- 

hold crossing  is  detected. 


Field  3 may  be  repeated  so  that  up  to  10  tasks  may  be  signaled 
as  a result  of  one  threshold  crossing. 


i 
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MSW  - Monitor  Actuated  Switching 


This  data  card  is  used  only  if  switches  are  to  be  set 
as  a result  of  a threshold  crossing.  Only  one  MSW  card 
per  monitor  is  allowed. 

Field  Value  Default  Description 

1 A Card  identification  (MSW)  . 

2 I Monitor  number. 

3 I Index  of  the  switch  to  be  affected. 

410  Value  to  be  assumed  by  the  switch 

specified  in  Field  3. 

Fields  3 and  4 may  be  repeated  so  that  up  to  10  switches 
may  be  affected  as  a result  of  one  threshold  crossing. 
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SST  - State  Variable  Statistics  Information 

This  card  type  is  required  for  state  variables  to  be 
observed  for  statistical  purposes. 


Field  Value  Default  Description 

1 A Card  identification  (SST) . 

2 I Statistic  number. 

3 I The  index  of  the  SS  ( • ) variable 

to  be  observed  (if  positive) ; the 
index  of  the  DD ( • ) variable  to  be 
observed  (if  negative) . 


4 A " " Alphanumeric  label  to  be  associated 

with  variable  identified  in  Field 
2 (maximum  of  8 characters) . 

5 R 0.  The  initial  value  of  the  variable 

specified  in  Field  2. 


Fields  2-5  may  be  repeated  so  that  a total  of  10  statistics 
can  be  specified  in  a single  input  record.  Additional  SST 
cards  may  also  be  used. 


State  Variable  Plots/Tables 

Plot/table  information  is  contained  on  two  types  of 
data  cards.  The  first  card  (PLO  card)  contains  information 
on  the  plot/table.  The  second  card  (VAR  card)  contains 
information  on  the  variables  to  be  plotted/tabled.  One  or 
more  VAR  cards  may  be  input  to  describe  the  variables  to  be 
included  in  the  plot/table  described  by  PLO.  One  PLO  card 
and  its  associated  VAR  cards  are  required  for  each  plot/table. 


PLO  - State  Variable  Plot/Table  Characteristics 


Field  Value  Default  Description 

1 A Card  identification  (PLO)  . 

2 I Plot/table  number. 

3 A TIME  Independent  axis  label  (maximum 


of  8 characters) . 

Storage  medium  to  be  used  for  plot/ 
table  values 

> 0 Peripheral  storage  unit  number 
on  which  plot/table  information 
is  to  be  written  (required  if 
multiple  plots/tables  are 
desired)  . 

= 0 Plot/table  information  to  be 
stored  in  core  (QPSET ( • ) ) . 

Only  1 plot/table  can  be  re- 
quested and  Fig.ld  2 must  be  set 
to  1 if  core  is  used. 

5 A P Plot/table  option 

Quick-Quick  plot 
Plot-Plot  only 
Table-Table  only 
Both-Plot  and  Table. 
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R 5.  Increment  of  the  independent  variable 

between  successive  plot  points. 


VAR  - State  Variable  Plot/Table  Variable  Information 


Field  Value  Default  Description 

1 A Card  identification  (VAR)  . 

2 I Plot  number  (same  as  Field  2 

of  associated  PLO  card) . 

3 I Variable  number. 

4 I Index  of  the  variable  to  be 

plotted/tabled 
> 0 SS  ( • ) variable 
= o Error 

< 0 DD ( • ) variable 


5 A value  in  field  3 Plot  symbol  (maximum  of  1 

character) . 

6 A " " Label  associated  with  the  varia- 

ble being  plotted/tabled  (maxi- 
mum of  8 characters) . 


7 A M Key  for  specifying  the  lower 

limit  of  the  scale  to  be  used 
for  the  variable  specified  in 
Field  4 

Minimum-Use  minimum  value  ob- 
served during  the  simula- 
tion 

Value-Use  the  value  in  Field  9 
Rounded-Use  the  largest  multiple 
of  the  value  specified  in 
Field  9 that  is  less 
than  or  equal  to  the 
minimum  value  observed. 

8 A M Key  for  specifying  the  upper 

limit  of  the  scale  to  be  used  for 
the  variable  specified  in  Field  4 
Maximum-Use  maximum  value  ob- 
served during  the  simula- 
tion 

Value-Use  the  value  in  Field  10 
Rounded-Use  the  smallest  multiple 
of  the  value  specified 
in  Field  10  that  is 
greater  than  or  equal  to 
the  maximum  value  observed. 


Field  Value 


Default 


0. 
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0. 


Description 

Value  associated  with  the  lower 
limit  of  the  plot  ordinate 
(see  Field  7) . 

Value  associated  with  the  upper 
limit  of  the  plot  ordinate 
(see  Field  8) . 


Fields  3-10  may  be  repeated  so  that  up  to  6 variables 
may  be  described  on  a single  data  card.  Additional  VAR  cards 
may  also  be  used  to  describe  additional  variables. 


Condensed  Data  Input  Description 

A condensed  version  of  the  SAINT  data  input  description 
is  presented  in  Table  6.  This  table  is  provided  for  the 
user  who  is  already  familiar  with  the  detailed  description 
presented  previously  and  desires  a brief  description  of  each 
input  field  for  his  continued  use. 

A brief  description  of  each  data  input  field  is  provided 
in  Table  6.  Abbreviations  are  used  frequently.  If  a field 
is  required,  no  default  values  are  shown.  However,  if  an 
input  field  is  not  required,  the  default  value  assigned  to 
that  field  by  SAINT  is  shown  in  parentheses  following  the 
description  of  the  field  contents.  Some  default  values  are 
based  on  the  values  input  in  preceding  or  succeeding  fields. 

For  example,  if  the  default  value  for  field  3 is  the  value 
input  for  field  2,  the  default  value  for  field  3 will  be  shown 
as  (F2) . In  addition,  some  input  fields  can  take  one  of 
two  default  values,  depending  on  the  specific  situation. 

Default  values  of  this  type  are  shown  as  (0/1) . An  explanation 
of  the  conditions  under  which  the  default  value  is  selected 
is  provided  in  the  detailed  input  description. 

Many  SAINT  data  cards  allow  certain  fields  to  be  re- 
peated in  order  to  facilitate  the  preparation  of  data  input. 

For  each  data  card  with  this  characteristic,  the  fields  that 
may  be  repeated  are  identified.  In  addition,  the  maximum 
number  of  times  that  the  repeating  set  of  fields  may  be 
included  on  the  data  card  is  indicated. 

Once  again.  Table  6 is  designed  for  the  SAINT  user  who 
is  familiar  with  and  has  used  the  detailed  input  description.  • 
Since  many  abbreviations  are  employed,  care  should  be  taken 
in  using  the  condensed  input  description.  When  in  doubt  about 
the  contents  of  a field,  the  user  should  refer  to  the  de- 
tailed input  description  for  clarification.  The  page  number 
of  the  detailed  input  description  for  each  data  type  is  shown 
below  the  card  identifier  in  Field  1. 


UHI  Histo.  Label  of  Lim.  of  Width  Repeat  Fields  2-6;  Maximum 

(49)  Number  Cells  Cell  1 


SECTION  IV 


SAINT  USER-WRITTEN  SUBPROGRAMS 

; 

1 

SAINT  includes  nine  user-written  subprograms  that 
are  used  to  define  additional  model  components.  These 
subprograms  and  the  functions  they  can  perform  are  shown 
in  Table  7.  By  including  the  appropriate  SAINT  COMMON 
blocks,  all  SAINT  COMMON  variables  are  available  to  the 
user.  In  addition,  the  user  has  access  to  the  user  support 
subprograms  that  are  described  in  Section  V. 


TABLE  7 


I 

j 

i 


f 

I 


! 


SAINT  USER-WRITTEN  SUBPROGRAMS 


Subprograms 


Subroutine  ENDIT (NITER) 


Subroutine  INTLC 


Subroutine  MODRF (MFN , NNODE ) 


Function  PRIOR (ITASK) 


Subroutine  STATE 


Function 

Prepares  user-generated  itera- 
tion summary  report  for  itera- 
tion NITER  and  initializes 
user-generated  statistical 
storage  arrays.  Automatically 
called  by  SAINT  at  the  end  of 
iteration  NITER. 

Defines  the  initial  values  of 
the  state  variable  vector  SS(*) 
and  the  switch  vector  IS ( • ) . 
Automatically  called  by  SAINT 
at  the  end  of  state  variable 
data  input  processing. 

Computes  and  causes  the  effect 
of  moderator  function  MFN  on 
the  performance  of  task  NNODE. 
The  effect  can  alter  TTIME , 
the  baseline  task  performance, 
or  PFIRB , the  probability  of 
taking  the  first  branch  speci- 
fied upon  completion  of  the 
task.  Automatically  called  by 
SAINT  if  moderator  function 
MFN  is  active  when  the  perfor- 
mance of  NNODE  is  being 
scheduled. 

Computes  the  priority  PRIOR  of 
task  ITASK  prior  to  the  assign- 
ment of  resources.  Automatical- 
ly called  by  SAINT  immediately 
preceding  the  assignment  of 
resources  to  tasks  that  have 
been  released. 

Contains  algebraic,  difference, 
and  differential  equations 
which  define  the  state  varia- 
bles of  the  model.  Automatical- 
ly called  by  SAINT  when  the 
values  of  state  variables  are 
to  be  updated. 
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Function 


Subprograms 
Subroutine  UERR  (KODE) 


Subroutine  UINPT 


Function  USERF ( JJ) 


Subroutine  UOTPT 


Prepares  user-generated  error 
report  when  a SAINT  execution 
error  occurs.  Automatically 
called  by  SAINT  when  execution 
error  KODE  is  detected. 

Reads  user-generated  input  data. 
Automatically  called  by  SAINT 
following  the  processing  of  all 
SAINT  input  data. 

Determines  the  value  of  USERF 
when  the  user-written  function 
(UF)  is  specified  on  input. 

The  value  of  JJ  is  the  para- 
meter specification  associated 
with  the  function. 

Prepares  user-generated  simula- 
tion summary  report  for  user- 
generated statistics  and  other 
user-defined  quantities. 
Automatically  called  by  SAINT 
at  the  end  of  all  required 
iterations . 
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SECTION  V 


SAINT  USER  SUPPORT  SUBPROGRAMS 


With  the  advent  of  SAINT  user-written  subprograms, 
the  SAINT  user  may  require  direct  access  to  SAINT  variables. 
Since  SAINT  maintains  lists  and  pointer  systems,  a number 
of  subprograms  are  provided  to  facilitate  the  retrieval  of 
variable  values.  These  user-callable  support  subprograms 
allow  the  user  to  access  frequently  required  SAINT  variables 
as  well  as  to  collect  statistics  on  any  user-defined 
variables.  They  are  organized  by  function  in  the  following 
six  tables,  where  their  descriptions  and  argument  definitions 
are  given. 


Table  Number 
8 
9 

10 

11 

12 


Function 

Attribute  Values 

User-Defined  Task  Characteristics 
Task  Scheduling 
Random  Deviate  Generators 
User-Generated  Statistics 


13 


Simulation  Status 


TABLE  8 


SAINT  USER  SUPPORT  SUBPROGRAMS: 
ATTRIBUTE  VALUES 


Subprogram 

Subroutine  GETIA(NAT,VALUE) 

Subroutine  PUTI A (NAT , VALUE ) 

Subroutine  GETRA(NRE, NAT, VALUE) 

Subroutine  PUTRA (N RE , NAT , VALUE) 

Subroutine  GETSA (NAT, VALUE) 
Subroutine  PUTS A (NAT , VALUE ) 


Function 

Retrieves  VALUE  as  the  value 
of  information  attribute  NAT 
of  the  information  packet 
associated  with  the  task  now 
being  processed. 

Sets  information  attribute 
NAT  of  the  information 
packet  associated  with  the 
task  now  being  processed 
to  the  value  of  VALUE. 

Retrieves  VALUE  as  the  value 
of  resource  attribute  NAT 
of  resource  NRE . 

Sets  resource  attribute  NAT 
of  resource  NRE  to  the 
value  of  VALUE. 

Retrieves  VALUE  as  the  value 
of  system  attribute  NAT. 

Sets  system  attribute  NAT 
to  the  value  of  VALUE. 
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TABLE  9 


SAINT  USER  SUPPORT  SUBPROGRAMS; 
USER-DEFINED  TASK  CHARACTERISTICS 


Subprogram 

Subroutine  GETTC  (NNODE,NCHAR, VALUE) 

Subroutine  PUTTC  (NNODE, NCHAR,  VALUE) 


Function 

Retrieves  VALUE  as  the  value 
of  user-defined  task  charac- 
teristic NCHAR  of  task  NNODE . 

Sets  User-defined  task  charac- 
teristic NCHAR  Of  task  NNODE 
to  the  value  of  VALUE. 
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TABLE  10 


SAINT  USER  SUPPORT  SUBPROGRAMS: 
TASK  SCHEDULING 


Subprogram 


Subroutine  GETPR (ITASK, VALUE) 


Subroutine  PUTPR (ITASK, VALUE) 
Subroutine  QRANK (I RANK) 


Function  TIMEQ(IDUM) 


Function  TMARK(IDUM) 


Function 


Retrieves  VALUE  as  the  value  of 
the  task  priority  of  task 
ITASK. 

Sets  the  task  priority  of  task 
ITASK  to  the  value  of  VALUE. 

Changes  the  ranking  procedure 
used  in  ranking  those  tasks 
awaiting  the  assignment  of 
resources  to  IRANK,  where 
IRANK  is  1 (low  value  first 
based  on  priority) , 2 (high 
value  first  based  on  priority) , 
3 (FIFO) , or  4 (LIFO) . 

Retrieves  the  time  that  the 
task  now  being  processed  has 
been  residing  in  the  file  of 
tasks  awaiting  the  assign- 
ment of  resources.  This 
function  is  only  accessible 
from  function  PRIOR.  The 
argument  IDUM  is  a dummy 
argument  required  by  ANSI 
FORTRAN . 

Retrieves  the  mark  time  con- 
tained in  the  information 
packet  associated  with  the 
task  now  being  processed. 

The  argument  IDUM  is  a dummy 
argument  required  by  ANSI 
FORTRAN . 
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TABLE  11 


SAINT  USER  SUPPORT  SUBPROGRAMS: 
RANDOM  DEVIATE  GENERATORS 


Subprogram 
Function  BETA ( J) 

Function  DRAND(IY) 


Function  ERLNG(J) 

Function  GAMM(J) 

Subroutine  NPOSN ( J,NPSSN) 

Function  RLOGN (J) 

Function  RNORM(J) 

Function  TRNGL(J) 

Function  UNFRM(J) 

Function  WEIBL(J) 


Function 


Generates  a random  deviate  from 
a Beta  or  Beta-Pert  distribution 
with  parameters  in  distribution 
set  J. 

Generates  a uniform  random  num- 
ber DRAND  over  the  interval 
(0,1)  using  the  computer  system's 
random  number  routine.  This 
function  is  machine  specific. 

The  argument  IY  is  the  initial 
random  number  seed  (ISEED) . 

Generates  a random  deviate  from 
an  Erlang  distribution  with 
parameters  in  distribution  set  J. 

Generates  a random  deviate  from 
a Gamma  distribution  with  para- 
meters in  distribution  set  J. 

Generates  a random  deviate  NPSSN 
from  a Poisson  distribution  with 
parameters  in  distribution  set  J. 

Generates  a random  deviate  from 
a log-normal  distribution  with 
parameters  in  distribution  set  J. 

Generates  a random  deviate  from 
a normal  distribution  with  para- 
meters in  distribution  set  J. 

Generates  a deviate  from  a triangu- 
lar distribution  with  parameters 
in  distribution  set  J. 

Generates  a random  deviate  from 
a uniform  distribution  with  para- 
meters in  distribution  set  J. 

Generates  a random  deviate  from 
a Weibull  distribution  with  para- 
meters in  distribution  set  J. 
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TABLE  12 


SAINT  USER  SUPPORT  SUBPROGRAMS: 
USER- GENERATED  STATISTICS 


Subprogram 
Subroutine  CLEAR 


Subroutine  CLRHI(IND) 


Subroutine  CLROB(IND) 


Subroutine  CLRPT(IND) 


Function 


Initializes  all  statistical 
storage  arrays  for  user-gener- 
ated statistics.  Automatically 
called  by  SAINT  following  the 
processing  of  all  input  data 
cards. 

Initializes  the  statistical 
storage  arrays  associated  with 
the  collection  of  user-generated 
histograms.  If  IND  is  equal  to 
0,  statistical  storage  for  all 
histgrams  is  initialized;  if 
IND  is  greater  than  0,  statisti- 
cal storage  for  the  histogram 
identified  by  IND  is  initialized. 

Initializes  the  statistical 
storage  arrays  associated  with 
the  collection  of  user-generated 
statistics  for  variables  based 
on  observation.  If  IND  is  equal 
to  0,  statistical  storage  for 
all  variables  based  on  observa- 
tion is  initialized;  if  IND  is 
greater  than  0,  statistical 
storage  for  the  variable  identi- 
fied by  IND  is  initialized. 

Initializes  storage  arrays  and 
peripheral  storage  units  asso- 
ciated with  the  preparation  of 
user-generated  plots.  If  IND 
is  equal  to  0,  storage  for  all 
user-generated  plots  is  initial- 
ized; if  IND  is  greater  than  0, 
storage  for  the  plot  identified 
by  IND  is  initialized. 
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Subprogram 

Subroutine  CLRTP(IND) 


Subroutine  UCLCT (XX , ICLCT) 


Subroutine  UHIST (XX, IHIST) 


Function 


Initializes  the  statistical 
storage  arrays  associated  with 
the  collection  of  user-generated 
statistics  for  time-persistent 
variables.  If  IND  is  equal  to 
0,  statistical  storage  for  all 
time-persistent  variables  is 
initialized;  if  IND  is  greater 
than  0,  statistical  storage 
for  the  variable  identified  by 
IND  is  initialized. 

If  ICLCT  is  greater  than  0, 
records  value  XX  as  an  obser- 
vation on  variable  ICLCT.  If 
ICLCT  equals  0,  computes  and 
reports  statistics  on  all 
variables  based  on  observation. 
If  ICLCT  is  less  than  0,  com- 
putes and  reports  statistics  on 
variable  -ICLCT. 

If  IHIST  is  greater  than  0, 
determines  the  cell  number 
associated  with  the  value  XX 
for  histogram  IHIST  and  in- 
creases the  cell  content  by  1. 

If  IHIST  equals  0,  prints  and 
plots  all  user-generated 
histograms.  If  IHIST  is  less 
than  0,  prints  and  plots  user- 
generated histogram  -IHIST. 


Subroutine  UPLOT (XX, T, IPLOT)  If  IPLOT  is  greater  than  0, 

I PLOT  is  the  plot  number  and 
UPLOT  stores  values  of  the 
dependent  variables  XX  (up  to 
ten  values  per  plot)  for  a 
value  of  the  independent  varia- 
ble T.  If  IPLOT  equals  0, 
prints  table  and/or  plot  for 
all  user-generated  plots.  If 
IPLOT  is  less  than  0,  prints 
table  and/or  plot  for  user- 
generated plot  -IPLOT. 


Subprogram  Function 

Subroutine  UTMSA (XX, T, ISTAT)  Integrates  variable  ISTAT 

assuming  that  the  value  during 
the  past  interval  is  the  average 
of  XX  and  the  value  XX  at  the 
last  cell  to  UTMSA  for  variable 
ISTAT.  Computation  and  re- 
porting for  variable  ISTAT  is 
performed  by  subroutine  UTMST. 

Subroutine  UTMST (XX, T, ISTAT)  If  ISTAT  is  greater  than  0, 

integrates  variable  ISTAT 
assuming  that  the  value  during 
the  interval  up  to  time  T is 
the  value  of  XX  at  the  last 
call  to  UTMST  for  variable 
ISTAT.  XX  is  the  value  that 
variable  ISTAT  will  have  during 
the  next  interval.  If  ISTAT 
equals  0 , computes  and  reports 
statistics  on  all  user-generated 
time-persistent  variables.  If 
ISTAT  is  less  than  0,  computes 
and  reports  statistics  on  user- 
generated time-persistent 
variable  -ISTAT. 
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TABLE  13 


SAINT  USER  SUPPORT  SUBPROGRAMS: 
SIMULATION  STATUS 


Subprogram 
Subroutine  DMPAR 

Subroutine  DMPMF 

Subroutine  DMPRS 

Subroutine  DMPSA 

Subroutine  DMPST 

Subroutine  DMPSV 


Function 


Prints  the  current  status  of  all 
tasks  awaiting  the  assignment  of 
resources . 

Prints  the  current  status  of  all 
moderator  functions. 

Prints  the  current  status  of  all 
resources . 

Prints  the  current  status  of  all 
system  attributes. 

Prints  the  current  status  of  all 
tasks  now  being  performed. 

Prints  the  current  status  of  all 
state  variables. 
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SECTION  VI 


SAINT  INPUT  ERRORS 


Two  separate  and  self-contained  input  processors  are 
available  for  use  with  the  SAINT  simulation  program.  The 
first  processor  performs  maximum  error  checking.  This 
processor  outputs  primary  error  specifications  following 
the  individual  card  iir.aqes  on  the  echo  check,  and  secondary 
error  specifications  following  the  complete  card  image 
echo  check.  When  a SAINT  input  error  occurs,  the  error 
will  be  identified  by  a printed  error  message  describing 
the  error  and  its  location. 

The  second  input  processor  performs  no  error  checking. 
It  should  be  used  only  when  the  SAINT  user  is  certain  that 
no  errors  appear  when  using  the  maximum  error  checking  input 
processor. 

With  these  capabilities,  the  user  will  be  able  to 
initially  check  his  input  data  using  the  maximum  error  check- 
ing processor  and  then  make  subsequent  runs  with  the  same 
data  deck  using  the  no  error  checking  processor  in  order  to 
save  computer  time.  For  both  input  processors,  all  undefined 
input  variables,  except  those  required  by  SAINT,  will  be 
given  default  values. 


SECTION  VII 


SAINT  EXECUTION  ERRORS 


The  SAINT  simulation  program  is  designed  to  monitor 
its  own  execution  and  detect  any  errors  that  arise.  When 
an  error  is  detected,  execution  is  automatically  terminated 
by  calculating  the  square  root  of  a negative  number,  so  that 
subprogram  traceback  information  will  be  printed.  SAINT 
then  provides  complete  information  detailing  the  status 
of  the  system  at  the  point  in  time  when  the  error  occurs. 

This  information  includes  the  error  code  number,  the  time 
that  the  error  occurred,  the  iteration  being  processed,  as 
well  as  the  current  status  of  all  tasks,  resources,  attributes, 
moderator  functions,  and  state  variables. 

When  a SAINT  execution  error  occurs,  the  error  will 
be  identified  by  an  error  code  number.  Table  14  provides  the 
description,  probable  cause,  and  location  associated  with 
each  error  code.  The  information  included  in  Table  14  along 
with  the  status  report  printed  when  the  error  occurs  should 
provide  sufficient  information  to  locate  and  correct  the  error. 

Following  the  printing  of  the  error  report,  SAINT 
automatically  calls  subroutine  UERR(KODE) . This  subroutine 
is  user-written  and  may  be  used  to  generate  user- required 
error  reports  on  the  status  of  user-defined  variables.  The 
argument  KODE  is  set  equal  to  the  code  number  of  the  error 
detected. 


i 
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TABLE  14 


SAINT  EXECUTION  ERROR  DESCRIPTIONS 


Error 

Code  Error  Condition 


Location  of 
Call  to  SERR 


3001  Failed  integration  accuracy  test;  user  UPDATE  144 
specified  execution  abort-  Probable 
cause:  specified  accuracy  requirements 

are  too  strict. 


3002  Failed  accuracy  test  in  locating  thres-  UPDATE  189 
hold  crossing;  user  specified  execution 
abort.  Probable  cause:  specified  accu- 
racy requirements  are  too  strict. 


3003 


3004 


3005 


Sum  of  the  branching  probabilities  for  a GASP  372 

task  that  requires  probabilistic  branch- 
ing does  not  equal  1.0.  Probable  cause: 
incorrect  assignment  of  branching  proba- 
bilities during  execution. 

One  of  the  branching  probabilities  for  a GASP  369 

task  that  requires  probabilistic  branch- 
ing is  less  than  0.  Probable  cause: 
incorrect  assignment  of  oranching  proba- 
bility during  execution. 

All  available  storage  for  information  GASP  478 

attribute  packets  has  been  allocated. 

Probable  cause:  associated  array  dimen- 
sions are  too  small  (see  Table  16,  No.  13, 
for  arrays  affected) . 


3006  All  available  storage  for  tasks  being  FT LEM  11 

performed  and  tasks  awaiting  assignment 

of  resources  has  been  allocated.  Probable 
cause:  associated  array  dimensions  are 

too  small  (see  Table  16,  No.  1,  for 
arrays  affected) . 

3007  Value  of  the  variable  TTIME  (task  per-  SCHAT  67 

formance  time)  is  less  than  0.  Probable 

cause:  incorrect  specification  of  varia- 

ble value  in  user-written  subprogram. 
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Error 

Code  Error  Condition 


3008  Value  of  the  variable  PFIRB  (proba- 

bility of  selecting  the  first  branch 
for  a task  that  requires  probabilistic 
branching)  is  less  than  0.  Probable 
cause:  incorrect  specification  of 

variable  value  in  user-written  subpro- 
gram. 

3009  Value  of  the  variable  PFIRB  (proba- 
bility of  selecting  the  first  branch 
for  a task  that  requires  probabilistic 
branching)  is  greater  than  1.  Proba- 
ble cause:  incorrect  specification  of 
variable  value  in  user-written  subpro- 
gram. 

3010  Not  all  sink  tasks  required  for  comple- 
tion of  simulation  have  been  performed. 

However,  no  other  tasks  are  being  per- 
formed. Probable  cause:  incorrect 
branching  specifications  (incorrect 
network  formulation) . 

3101  Distribution  set  number  specified  as  an 
argument  to  this  subprogram  refers  to  a 
distribution  set  that  contains  an  illegal 
distribution  type  for  this  subprogram. 

Probable  cause:  incorrect  specification 
of  argument  in  calling  subprogram. 

3102  Distribution  set  number  specified  as  an  BETA  4 

argument  to  this  subprogram  is  less  than 

or  equal  to  0.  Probable  cause:  incor- 
rect specification  of  argument  in  calling 
subprogram. 

3103  Distribution  set  number  specified  as  an  BETA  5 

argument  to  this  subprogram  is  greater 

than  the  largest  distribution  set  number 
specified  on  input.  Probable  cause: 
incorrect  specification  of  argument  in 
calling  subprogram. 

3104  Distribution  set  number  specified  as  an  ERLNG  8 

argument  to  this  subprogram  refers  to  a 
distribution  set  that  contains  an  illegal 
distribution  type  for  this  subprogram. 

Probable  cause:  incorrect  specification 
of  argument  in  calling  subprogram. 
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SCHAT  74 


SCHAT  75 


RMOVE  14 


BETA  7 
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3105  Distribution  set  number  specified  as  an  ERLNG  5 

argument  to  this  subprogram  is  less  than 

or  equal  to  0.  Probable  cause:  incor- 
rect specification  of  argument  in  calling 
subprogram. 

3106  Distribution  set  number  specified  as  an  ERLNG  6 

argument  to  this  subprogram  is  greater 

than  the  largest  distribution  set  number 
specified  on  input.  Probable  cause: 
incorrect  specification  of  argument  in 
calling  subprogram. 

3107  Distribution  set  number  specified  as  an  GAMM  7 

argument  to  this  subprogram  refers  to  a 
distribution  set  that  contains  an  illegal 
distribution  type  for  this  subprogram. 

Probable  cause:  incorrect  specification 
of  argument  in  calling  subprogram. 

3108  Distribution  set  number  specified  as  an  GAMM  4 

argument  to  this  subprogram  is  less  than 

or  equal  to  0.  Probable  cause:  incor- 
rect specification  of  argument  in  calling 
subprogram. 

3109  Distribution  set  number  specified  as  an  GAMM  5 

argument  to  this  subprogram  is  greater 

than  the  largest  distribution  set  number 
specified  on  input.  Probable  cause: 
incorrect  specification  of  argument  in 
calling  subprogram. 

3110  Distribution  set  number  specified  as  an  NPOSN  9 

argument  to  this  subprogram  refers  to  a 
distribution  set  that  contains  an  illegal 
distribution  type  for  this  subprogram. 

Probable  cause:  incorrect  specification 
of  argument  in  calling  subprogram. 

3111  Distribution  set  number  specified  as  an  NPOSN  6 

argument  to  this  subprogram  is  less  than 

or  equal  to  0.  Probable  cause:  incorrect 
specification  of  argument  in  calling  sub- 
program. 
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3112  Distribution  set  number  specified  as  an  NPOSN  7 

argument  to  this  subprogram  is  greater 

than  the  largest  distribution  set  number 
specified  on  input.  Probable  cause: 
incorrect  specification  of  argument  in 
calling  subprogram. 

3113  Distribution  set  number  specified  as  an  RLOGN  7 

argument  to  this  subprogram  refers  to  a 
distribution  set  that  contains  an  illegal 
distribution  type  for  this  subprogram. 

Probable  cause:  incorrect  specification 
of  argument  in  calling  subprogram. 

3114  Distribution  set  number  specified  as  an  RLOGN  4 

argument  to  this  subprogram  is  less  than 

or  equal  to  0.  Probable  cause:  incor- 
rect specification  of  argument  in  calling 
subprogram. 

3115  Distribution  set  number  specified  as  an  RLOGN  5 

argument  to  this  subprogram  is  greater 

than  the  largest  distribution  set  number 
specified  on  input.  Probable  cause: 
incorrect  specification  of  argument  in 
calling  subprogram. 

3116  Distribution  set  number  specified  as  an  RNORM  8 

argument  to  this  subprogram  refers  to  a 
distribution  set  that  contains  an  illegal 
distribution  type  for  this  subprogram. 

Probable  cause:  incorrect  specification 
of  argument  in  calling  subprogram. 

3117  Distribution  set  number  specified  as  an  RNORM  5 

argument  to  this  subprogram  is  less  than 

or  equal  to  0.  Probable  cause:  incorrect 
specification  of  argument  in  calling  sub- 
program. 

3118  Distribution  set  number  specified  as  an  RNORM  6 

argument  to  this  subprogram  is  greater 

than  the  largest  distribution  set  number 
specified  on  input.  Probable  cause: 
incorrect  specification  of  argument  in 
calling  subprogram. 


108 


Error 

Code 
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3120 


3121 


3122 


3123 

3124 

*1 

i 

3125 


Error  Condition 


Distribution  set  number  specified  as  an 
argument  to  this  subprogram  refers  to 
a distribution  set  that  contains  an 
illegal  distribution  type  for  this  sub- 
program. Probable  cause:  incorrect 
specification  of  argument  in  calling 
subprogram. 

Distribution  set  number  specified  as  an 
argument  to  this  subprogram  is  less  than 
or  equal  to  0.  Probable  cause:  incor- 
rect specification  of  argument  in  call- 
ing subprogram. 

Distribution  set  number  specified  as  an 
argument  to  this  subprogram  is  greater 
than  the  largest  distribution  set  number 
specified  on  input.  Probable  cause: 
incorrect  specification  of  argument  in 
calling  subprogram. 

Distribution  set  number  specified  as  an 
argument  to  this  subprogram  refers  to  a 
distribution  set  that  contains  an  illegal 
distribution  type  for  this  subprogram. 

Probable  cause:  incorrect  specification 
of  argument  in  calling  subprogram. 

Distribution  set  number  specified  as  an  UNFRM  5 

argument  to  this  subprogram  is  less  than 
or  equal  to  0.  Probable  cause:  incor- 
rect specification  of  argument  in  calling 
subprogram. 

Distribution  set  number  specified  as  an  UNFRM  6 

argument  to  this  subprogram  is  greater 
than  the  largest  distribution  set  number 
specified  on  input.  Probable  cause:  in- 
correct specification  of  argument  in  call- 
ing subprogram. 

Distribution  cet  number  specified  as  an  WEIBL  8 

argument  to  this  subprogram  refers  to  a 
distribution  set  that  contains  an  illegal 
distribution  type  for  this  subprogram. 

Probable  cause:  Incorrect  specification 
of  argument  in  calling  subprogram. 


Location  of 
Call  to  SERR 

TRNGL  8 


TRNGL  6 

TRNGL  7 


UNFRM  8 
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3126  Distribution  set  number  specified  as  an  WEIBL  5 

argument  to  this  subprogram  is  less  than 

or  equal  to  0.  Probable  cause:  incor- 
rect specification  of  argument  in  calling 
subprogram. 

3127  Distribution  set  number  specified  as  an  WEIBL  6 

argument  to  this  subprogram  is  greater 

than  the  largest  distribution  set  number 
specified  on  input.  Probable  cause:  in- 
correct specif ication  of  argument  in 
calling  subprogram. 

3201  Histogram  number  specified  as  an  argument  CLRHI  5 

to  this  subprogram  is  less  than  0.  Prob- 
able cause:  incorrect  specification  of 

argument  in  calling  subprogram. 

3202  Histogram  number  specified  as  an  argu-  CLRHI  6 

ment  to  this  subprogram  is  greater  than 

the  largest  histogram  number  specified  on 
input.  Probable  cause:  incorrect  speci- 
fication of  argument  in  calling  subprogram. 

3203  Statistic  number  specified  as  an  argument  CLROB  5 

to  this  subprogram  is  less  than  0.  Prob- 
able cause:  incorrect  specification  of 

argument  in  calling  subprogram. 

3204  Statistic  number  specified  as  an  argument  CLROB  6 

to  this  subprogram  is  greater  than  the 

largest  statistic  number  specified  on 
input.  Probable  cause:  incorrect  specifi- 
cation of  argument  in  calling  subprogram. 

3205  Plot  number  specified  as  an  argument  to  CLRPT  5 

this  subprogram  is  less  than  0.  Proba- 
ble cause:  incorrect  specification  of 

argument  in  calling  subprogram. 

3206  Plot  number  specified  as  an  argument  to  CLRPT  6 

this  subprogram  is  greater  than  the  larg- 
est plot  number  specified  on  input. 

Probable  cause:  incorrect  specification 
of  argument  in  calling  subprogram. 

3207  Statistic  number  specified  as  an  argu-  CLRTP  6 

ment  to  this  subprogram  is  less  than  0. 

Probable  cause:  incorrect  specification 
of  argument  in  calling  subprogram. 
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3208  Statistic  number  specified  as  an  argu-  CLRTP  7 

ment  to  this  subprogram  is  greater  than 

the  largest  statistic  number  specified  on 
input.  Probable  cause:  incorrect  speci- 
fication of  argument  in  calling  subprogram. 

3209  Clearing  of  user-generated  histograms  is  CLRHI  4 

requested.  However,  no  user-generated 

histograms  are  defined.  Probable  cause: 
call  made  to  inappropriate  clearing  sub- 
program from  a user-written  subprogram. 

3210  Clearing  of  user-generated  statistics  CLROB  4 

based  on  observation  is  requested.  How- 
ever, no  user-generated  statistics  based 

on  observation  are  defined.  Probable 
cause:  call  made  to  inappropriate  clear- 

ing subprogram  from  a user-written  sub- 
program. 

3211  Clearing  of  user-generated  statistics  CLRTP  5 

for  time  persistent  variables  is  re- 
quested. However,  no  user-generated 

statistics  for  time  persistent  variables 
are  defined.  Probable  cause:  call 
made  to  inappropriate  clearing  subpro- 
gram from  a user-written  subprogram. 

3212  Clearing  of  user-generated  plots  is  CLRPT  4 

requested.  However,  no  user-generated 

plots  are  defined.  Probable  cause:  call 
made  to  inappropriate  clearing  subprogram 
from  a user-written  subprogram. 

3301  Statistic  number  specified  as  an  argu-  UCLCT  9 

ment  to  this  subprogram  for  output  pur- 
poses is  greater  than  the  largest 

statistic  number  specified  on  input. 

Probable  cause:  incorrect  specification 
of  argument  in  calling  subprogram. 

3302  Statistic  number  specified  as  an  argu-  UCLCT  16 

ment  to  this  subprogram  is  greater  than 

the  largest  statistic  number  specified 
on  input.  Probable  cause:  incorrect 
specification  of  argument  in  calling  sub- 
program. 


Ill 
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of 

SERR 

3303 

Histogram  number  specified  as  an  argument 
to  this  subprogram  for  output  purposes 
is  greater  than  the  largest  histogram 
number  specified  on  input.  Probable 
cause:  incorrect  specification  of 

argument  in  calling  subprogram. 

UHIST 

10 

4 

3304 

Histogram  number  specified  as  an  argu- 
ment to  this  subprogram  is  greater  than 
the  largest  histogram  number  specified 
on  input.  Probable  cause:  incorrect 
specification  of  argument  in  calling 
subprogram. 

UHIST 

20 

3305 

Statistic  number  specified  as  an  argu- 
ment to  this  subprogram  is  less  than  or 
equal  to  0.  Probable  cause:  incorrect 
specification  of  argument  in  calling 
subprogram. 

UTMSA 

6 

i 

J 

3306 

Statistic  number  specified  as  an  argu- 
ment to  this  subprogram  is  greater  than 
the  largest  statistic  number  specified 
on  input.  Probable  cause:  incorrect 
specification  of  argument  in  calling 
subprogram. 

UTMSA 

7 

« 

3307 

Value  of  the  independent  variable  speci-  UTMSA 
fied  as  an  argument  to  this  subprogram 
is  not  greater  than  or  equal  to  the  last 
specified  value  of  the  independent  varia- 
ble. Probable  cause:  incorrect  speci- 
fication of  argument  in  calling  subprogram. 

11 

- 

3308 

Statistic  number  specified  as  an  argu- 
ment to  this  subprogram  for  output  pur- 
poses is  greater  than  the  largest  statis- 
tic number  specified  on  input.  Probable 
cause:  incorrect  specification  of 

argument  in  calling  subprogram. 

UTMST 

9 

3309 

Statistic  number  specified  as  an  argu- 
ment to  this  subprogram  is  greater  than 
the  largest  statistic  number  specified 
on  input.  Probable  cause:  incorrect 
specification  of  argument  in  calling 
subprogram. 

UTMST 

16 

i 
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3310 


3311 


3312 


3313 


Value  of  the  independent  variable  speci-  UTMST 
fied  as  an  argument  to  this  subprogram 
is  not  greater  than  or  equal  to  the  last 
specified  value  of  the  independent  varia- 
ble. Probable  cause:  incorrect  specifi- 
cation of  argument  in  calling  subprogram. 

Plot  number  specified  as  an  argument  to  UPLOT 
this  subprogram  for  output  purposes  is 
greater  than  the  largest  plot  number 
specified  on  input.  Probable  cause: 
incorrect  specification  of  argument  in 
calling  subprogram. 

Plot  number  specified  as  an  argument  to  UPLOT 
this  subprogram  is  greater  than  the 
largest  plot  number  specified  on  input. 

Probable  cause:  incorrect  specification 
of  argument  in  calling  subprogram. 

Value  of  the  independent  variable  speci-  UPLOT 
fied  as  an  argument  to  this  subprogram 
is  not  monotonic.  Probable  cause:  incor- 
rect specification  of  argument  in  calling 
subprogram. 


18 


29 


11 


132 


3314  Collection  or  reporting  of  user-generated  UHIST  7 

histograms  is  requested.  However,  no 
user-generated  histograms  are  defined. 

Probable  cause:  call  made  to  inappropriate 
subprogram  from  a user-written  subprogram. 

3315  Collection  or  reporting  of  user-generated  UCLCT  6 

statistics  based  on  observation  is  reques- 
ted. However,  no  user-generated  statistics 

based  on  observation  are  defined.  Probable 
cause:  call  made  to  inappropriate  subpro- 

gram from  a user-written  subprogram. 

3316  Collection  or  reporting  of  user-generated  UTMSA  5 

statistics  for  time  persistent  variables 

is  requested.  However,  no  user-generated 
statistics  for  time  persistent  variables 
are  defined.  Probable  cause:  call  made 
to  inappropriate  subprogram  from  a user- 
written  subprogram. 
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3317  Collection  or  reporting  of  user-genera-  UTMST  6 

ted  statistics  for  time  persistent  varia- 
bles is  requested.  However,  no  user-gen- 
erated statistics  for  time  persistent 
variables  are  defined.  Probable  cause: 
call  made  to  inappropriate  subprogram  from 
a user-written  subprogram. 


3318 


3319 


3320 


3401 


3402 


3403 


3404 


Collection  or  reporting  of  user-genera-  UPLOT 
ted  plots  is  requested.  However,  no 
user-generated  plots  are  defined.  Prob- 
able cause:  call  made  to  inappropriate 
subprogram  from  a user-written  subprogram. 


The  number  of  variables  for  the  plot 
specified  as  an  argument  to  this  sub- 
program is  0.  Collection  for  this  plot 
has  been  requested.  Probable  cause: 
incorrect  specification  of  argument  in 
calling  subprogram. 

The  number  of  variables  for  the  plot 
specified  as  an  argument  to  this  sub- 
program is  0.  Reporting  for  this  plot 
has  been  requested.  Probable  cause: 
incorrect  specification  of  argument  in 
calling  subprogram. 

Attribute  number  specified  as  an  argu- 
ment to  this  subprogram  is  less  than 
or  equal  to  0.  Probable  cause:  incor- 
rect specification  of  argument  in 
calling  subprogram. 

Attribute  number  specified  as  an  argu- 
ment to  this  subprogram  is  greater  than 
the  largest  attribute  number  specified 
on  input.  Probable  cause:  incorrect 
specification  of  argument  in  calling 
subprogram. 

Task  number  specified  as  an  argument 
to  this  subprogram  is  less  than  or 
equal  to  0.  Probable  cause:  incor- 
rect specification  of  argument  in 
calling  subprogram. 

Task  number  specified  as  an  argument 
to  this  subprogram  is  greater  than  the 
largest  task  number  specified  on  input. 
Probable  cause:  incorrect  specifica- 
tion of  argument  in  calling  subprogram. 
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UPLOT 


GETIA 


GETIA 


GETPR 


GETPR 


9 


14 


30 


5 


6 


4 
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3406 


3407 

3408 


3409 

3410 

3411 

3412 


Error  Condition 


Attribute  number  specified  as  an  argu- 
ment to  this  subprogram  is  less  than 
or  equal  to  0.  Probable  cause:  incor- 
rect specification  in  calling  subprogram. 

Attribute  number  specified  as  an  argu- 
ment to  this  subprogram  is  greater  than 
the  largest  attribute  number  specified 
on  input.  Probable  cause:  incorrect 
specification  of  argument  in  calling 
subprogram. 

Resource  number  specified  as  an  argument 
to  this  subprogram  is  less  than  or  equal 
to  0.  Probable  cause:  incorrect  speci- 
fication in  argument  in  calling  subprogram. 

Resource  number  specified  as  an  argument  GETRA  8 

to  this  subprogram  is  greater  than  the 

largest  resource  number  specified  on 

input.  Probable  cause:  incorrect 

specification  of  argument  in  calling 

subprogram. 

Attribute  number  specified  as  an  argument  GETSA  4 

to  this  subprogram  is  less  than  or  equal 
to  0.  Probable  cause:  incorrect  speci- 
fication of  argument  in  calling  subprogram. 

Attribute  number  specified  as  an  argument  GETSA  5 

to  this  subprogram  is  greater  than  the 
largest  attribute  number  specified  on 
input.  Probable  cause:  incorrect  speci- 
fication of  argument  in  calling  subprogram. 

Characteristic  number  specified  as  an  GETTC  7 

argument  to  this  subprogram  is  less  than 
or  equal  to  0.  Probable  cause:  incorrect 
specification  of  argument  in  calling  sub- 
program. 

Characteristic  number  specified  as  an  GETTC  8 

argument  to  this  subprogram  is  not  defined 
for  the  task  specified  as  an  argument. 

Probable  cause:  incorrect  specification 
of  argument  in  calling  subprogram. 
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GETRA  5 

GETRA  6 


GETRA  7 
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3413 

Task  number  specified  as  an  argument 
to  this  subprogram  is  less  than  or  equal 
to  0.  Probable  cause:  incorrect  speci- 

GETTC 

5 

fication  of  argument  in  calling  subprogram. 

3414 

Task  number  specified  as  an  argument  to 
this  subprogram  is  greater  than  the 
largest  task  number  specified  on  input. 
Probable  cause:  incorrect  specification 
of  argument  in  calling  subprogram. 

GETTC 

6 

3501 

Attribute  number  specified  as  an  argument  PUTIA 
to  this  subprogram  is  less  than  or  equal 
to  0.  Probable  cause:  incorrect  speci- 
fication of  argument  in  calling  subprogram. 

5 

1 

3502 

Attribute  number  specified  as  an  argu-  PUTIA 

ment  to  this  subprogram  is  greater  than 
the  largest  attribute  number  specified  on 
input.  Probable  cause:  incorrect  speci- 
fication of  argument  in  calling  subprogram. 

6 

J 

4 

4 

3503 

Task  number  specified  as  an  argument  to  PUTPR 

this  subprogram  is  less  than  or  equal 
to  0.  Probable  cause:  incorrect  speci- 
fication of  argument  in  calling  subprogram. 

4 

1 

] 

3504 

Task  number  specified  as  an  argument  to 
this  subprogram  is  greater  than  the  larg- 
est task  number  specified  on  input. 
Probable  cause:  incorrect  specification 
of  argument  in  calling  subprogram. 

PUTPR 

5 

‘ | 

< 

*"  1 

3505 

Attribute  number  specified  as  an  argu- 
ment to  this  subprogram  is  less  than  or 
equal  to  0.  Probable  cause:  incorrect 
specification  in  calling  subprogram. 

PUTRA 

7 

1 

3506 

Attribute  number  specified  as  an  argu- 
ment to  this  subprogram  is  greater  than 
the  largest  attribute  number  specified 
on  input.  Probable  cause:  incorrect 
specification  of  argument  in  calling 
subprogram. 

PUTRA 

8 

1 

I 

3507 

Resource  number  specified  as  an  argument 
to  this  subprogram  is  less  than  or  equal 
to  0.  Probable  cause:  incorrect  speci- 
fication of  argument  in  calling  subpro- 
gram. 

PUTRA 

5 

| 
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3508  Resource  number  specified  as  an  argu-  PUTRA  6 

ment  to  this  subprogram  is  greater  than 

the  largest  resource  number  specified  on 
input.  Probable  cause:  incorrect  speci- 
fication of  argument  in  calling  subprogram. 

3509  Attribute  number  specified  as  an  argu-  PUTSA  4 

ment  to  this  subprogram  is  less  than  or 

equal  to  0.  Probable  cause:  incorrect 
specification  of  argument  in  calling 
subprogram. 

3510  Attribute  number  specified  as  an  argu-  PUTSA  5 

ment  to  this  subprogram  is  greater  than 

the  largest  attribute  number  specified  on 
input.  Probable  cause:  incorrect  speci- 
fication of  argument  in  calling  subprogram. 

3511  Characteristic  number  specified  as  an  PUTTC  7 

argument  to  this  subprogram  is  less 

than  or  equal  to  0.  Probable  cause:  in- 
correct specification  of  argument  in 
calling  subprogram. 

3512  Characteristic  number  specified  as  an  PUTTC  8 

argument  to  this  subprogram  is  not  de- 
fined for  the  task  specified  as  an  argu- 
ment. Probable  cause:  incorrect  speci- 
fication of  argument  in  calling  subprogram. 

3513  Task  number  specified  as  an  argument  to  PUTTC  5 

this  subprogram  is  less  than  or  equal 

to  0.  Probable  cause:  incorrect  speci- 
fication of  argument  in  calling  subprogram. 

3514  Task  number  specified  as  an  argument  to  PUTTC  6 

this  subprogram  is  greater  than  the 

largest  task  number  specified  on  input. 

Probable  cause:  incorrect  specification 
of  argument  in  calling  subprogram. 

3515  Ranking  rule  specified  as  an  argument  to  QRANK  5 

this  subprogram  is  not  equal  to  1,  2,  3, 

or  4.  Probable  cause:  incorrect  speci- 
fication of  argument  in  calling  subprogram. 

3601  Report  on  the  status  of  moderator  func-  DMPMF  10 

tions  is  requested.  However,  no  moderator 
functions  are  defined.  Probable  cause: 
call  made  to  inappropriate  status  report- 
ing subprogram  from  a user-written  subpro- 
gram. 
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3602  Report  on  status  of  resources  is  request-  DMPRS  14 

ed.  However,  no  resources  are  defined. 

Probable  cause:  call  made  to  inappropriate 
status  reporting  subprogram  from  a user- 
written  subprogram. 

3603  Report  on  status  of  system  attributes  is  DMPSA  10 

requested.  However,  no  system  attributes 

are  defined.  Probable  cause:  call  made 
to  inappropriate  status  reporting  subpro- 
gram from  a user-written  subprogram. 

3604  Report  on  status  of  state  variables  is  DMPSV  8 

requested.  However,  no  state  variables 

are  defined.  Probable  cause:  call  made 
to  inappropriate  status  reporting  sub- 
program from  a user-written  subprogram. 
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SECTION  VIII 


SAINT  OPERATING  PROCEDURES 


SAINT  is  written  in  ANSI  standard  FORTRAN  IV  and  can 
be  run  on  any  machine  that  has  a FORTRAN  compiler.  In 
this  and  subsequent  sections,  general  information  relative 
to  the  operation  of  the  SAINT  program  is  provided. 

SAINT  normally  utilizes  four  input  and  output  devices. 
The  variable  NCRDR  is  set  to  the  input  device  number.  The 
variable  NPRNT  is  set  to  the  output  device  number.  The 
variable  NRNIT  is  set  to  a peripheral  device  number  to  be 
used  during  input  processing  and  initialization  prior  to 
each  iteration.  Output  to  this  device  is  formatted.  The 
variable  NRENT  is  set  to  a peripheral  device  number  to  be 
used  during  the  reinitialization  of  program  variables  at  the 
end  of  each  iteration.  The  values  of  these  variables  are 
specified  in  the  main  program.  In  the  version  of  SAINT  docu- 
mented herein  and  available  for  distribution,  these  varia- 
bles are  defined  as  NCRDR=5,  NPRNT=6 , NRNIT=8 , and  NRENT=9 . 
The  variable  NPUNCH  is  also  defined  in  the  main  program 
for  the  convenience  of  the  user  in  generating  punched  card 
output.  It  is  defined  as  NPUNCH=7.  In  addition,  SAINT 
utilizes  peripheral  devices  in  the  preparation  of  state 
variable  and  user-generated  plots.  The  device  numbers  to 
be  used  are  specified  by  the  user  on  SAINT  data  cards.  The 
devices  should  be  made  available  through  the  use  of  proper 
JCL  for  the  user's  machine. 

In  SAINT,  function  DRAND  is  the  only  machine-specific 
subprogram.  Function  DRAND  is  used  by  SAINT  to  generate 
a pseudo-random  number  in  the  interval  (0,1).  It  is  suggest- 
ed that  the  coding  of  function  DRAND  be  replaced  by  the 
random  number  generator  in  use  at  your  computer  center. 
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SECTION  IX 


SAINT  OVERLAY  STRUCTURE 


The  basic  philosophy  employed  in  the  design  of  SAINT 
was  that  additions,  modifications,  and  deletions  are  to  be 
expected.  Because  of  this,  the  SAINT  computer  program  was 
designed  in  a modular  form  to  facilitate  adaptation.  This 
same  design  philosophy  allows  efficient  use  of  core  storage 
by  providing  the  means  to  develop  a storage-saving  overlay 
structure. 

In  designing  the  SAINT  overlay  structure,  the  SAINT 
subprograms  were  divided  into  four  groups.  The  first  group 
of  subprograms  remains  in  core  storage  throughout  the  simu- 
lation process.  The  other  three  groups  are  brought  into  core 
storage  one  at  a time,  dependent  upon  the  status  of  the  simu- 
lation being  performed.  Table  15  shows  the  manner  in  which 
the  SAINT  subprograms  were  divided  into  groups. 

Group  1 remains  in  core  storage  throughout  the  program's 
execution,  as  the  subprograms  contained  within  Group  1 are 
accessed  from  more  than  one  of  the  remaining  three  subpro- 
gram groups.  When  the  main  program  calls  subroutine  DATIN 
to  begin  processing  the  SAINT  data  cards,  group  2 is  brought 
into  core  storage  along  with  group  1. 

After  processing  all  data  cards,  subroutine  DaTIN 
returns  control  to  the  main  program.  The  main  program  then 
calls  subroutine  GASP,  causing  group  2 to  be  removed  from 
core  storage  and  group  3 to  be  brought  in.  Group  3 contains 
all  subprograms  necessary  to  perform  the  simulation. 

When  all  iterations  have  been  completed,  subroutine  GASP 
returns  control  to  the  main  program.  The  main  program  then 
calls  subroutine  SUMRY  for  the  purpose  of  preparing  the 
required  output  reports.  This  causes  group  3 to  be  removed 
from  core  storage  and  group  4 to  be  inserted. 

Following  the  completion  of  the  summary  reports,  sub- 
routine SUMRY  returns  control  to  the  main  program.  If  no 
additional  SAINT  networks  are  to  be  simulated,  execution 
is  terminated.  However,  if  additional  networks  are  to  be 
analyzed,  the  entire  simulation  process  is  restarted  with  a 
call  to  DATIN  from  the  main  program. 
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TABLE  15 


GROUPINGS  OF  SAINT  SUBPROGRAMS 


Group  1 

Group 

2 

Group 

3 

ASSGN 

ATASS 

LPACK 

ATSET 

QRANK 

BETA 

BETAXF 

MSWT 

COLST 

RMOVE 

CLEAR 

BUILD 

MTASK 

END  IT 

RPLOT 

CLRHI 

CNCVT 

NMOD 

FILEM 

SCHAT 

CLROB 

CONDIT 

OUTPT 

GASP 

SCHED 

CLRPT 

CVT 

PERTXF 

GETIA 

SCOND 

CLRTP 

DAT  IN 

PLOTS 

GETPR 

SSAVE 

DMPAR 

DET 

PNABA 

GETRA 

TIMEQ 

DMPFL 

DFAUS 

POP 

GETSA 

TMARK 

DMPMF 

DFAUT 

PROB 

GETTC 

UPDATE 

DMPRS 

DISTR 

RCLEAR 

MODRF 

DMPSA 

DMODS 

REG 

NFIND 

DMPST 

DSWT 

SGEN 

PRIOR 

DMPSV 

ECHO 

STAT 

PUTIA 

DRAND 

ECHOS 

STATT 

PUTPR 

ERLNG 

ERRIN 

TASK 

PUTRA 

GAM 

GEN 

TCLEAR 

PUTSA 

GAMM 

GTCHAR 

UCOLL 

PUTTC 

HISTO 

IMODFN 

UHSTO 

INTLC 

INIT 

UINPT 

NPOSN 

INITS 

UPLTS 

PRNTH 

IRATT 

UTIME 

PRNTS 

ISATT 

UVAR 

RLOGN 

MAP 

VAR 

RNORM 

MODFN 

SERR 

MON  IT 

STATE 

TRNGL 

UCLCT 

UERR 

UHIST 

UNFRM 

UPLOT 

USERF 

UTMSA 

UTMST 

WEIBL 

LLABL 

Group  4 

SUMRY 

UOTPT 
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SECTION  X 


DIMENSION  REQUIREMENTS  FOR  SAINT  ARRAYS 


The  version  of  the  SAINT  simulation  program  documented 
herein  and  available  for  distribution  has  been  designed  to 
accommodate  a model  with  the  characteristics  listed  in  Table 
16. 


The  model  characteristics  that  the  SAINT  program  will 
accept  can  be  altered  by  changing  the  values  of  the  variables 
given  in  column  3 of  Table  16  to  the  desired  values  in  the 
main  program  and  by  changing  the  dimensions  of  the  arrays 
affected  (column  5)  in  the  main  program  and  all  SAINT  sub- 
programs where  their  associated  COMMON  block  appears.  The 
main  program  for  SAINT  is  shown  in  Figure  7.  A general 
description  of  the  characteristic  associated  with  each  COMMON 
block  appears  in  Table  17.  The  COMMON  blocks  included  in 
each  SAINT  subprogram  are  shown  in  Table  18.  The  definitions 
of  all  SAINT  COMMON  variables  are  provided  in  Documentation 
for  the  SAINT  Simulation  Program  (2) . 

For  example,  assume  that  a SAINT  model  requires  that  the 
largest  task  number  be  500.  Entry  3 of  Table  16  provides 
the  information  for  altering  the  largest  task  number.  The 
name  of  the  variable  that  is  set  to  the  largest  task  number 
is  IMN  (presently  set  to  100).  Thus,  the  first  step  in  the 
alteration  process  is  to  remove  the  following  statement  from 
the  main  program: 


IMN  = 100 

and  replace  it  with  the  statement: 

IMN  = 500. 

Once  this  has  been  accomplished,  the  next  step  in  the 
alteration  process  involves  changing  the  dimensions  of  the 
arrays  affected,  as  shown  in  column  5,  from  100  to  500. 

Thus,  all  dimensioned  arrays  which  appear  in  the  COMMON 
block  COM 10  must  be  altered.  The  arrays  included  in  COM10 
are  shown  in  the  main  program  (Figure  7) . The  new  version  of 
COM 10 , where  all  arrays  are  dimensioned  to  500,  will  replace 
the  old  version  in  the  main  program.  In  addition.  Table  18 
indicates  that  COM10  must  also  be  replaced  in  32  SAINT  sub- 
programs . 

As  soon  as  the  alterations  described  above  have  been 
completed,  the  SAINT  program  will  accept  models  whose  largest 
task  number  is  500.  The  same  alteration  procedure  is  to  be 
followed  in  order  to  change  any  of  the  other  model  character- 
istics . 
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TMENSION  REQUIREMENTS  FOR  SAINT  ARRAYS 
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Ai 


COMMON  /COMO  1 / 

COMMON  /COM  02/ 
COMMON  /COMO  3/ 

COMMON  /C 0 M 0 4 / 
COMMON  /C0MQ5/ 
CCMMON  /COM Ofe/ 
COMMON  /COM  07 / 

CCMMON  /COMO  5/ 

COMMON  /COMOO/ 
COMMON  /COMIC/ 


COMMON  /COMU/ 

COMMON  /COM1Z/ 
CCMMON  /COM! 3 / 
CCMMON  /COM14/ 


COMMON  /C0M15/ 
COMMON  /COM16/ 


CCMMON  /COM1 7/ 
CCMMON  /COM18/ 
CCMMON  /C0M19/ 

CCMMON  /COM20/ 
COMMON  /COM21/ 


COMMON  /C0M22/ 
CCMMON  /C0M23/ 


CCMMON  /COM24/ 


10, IN, I MM, I MNA, IMN, Mixes. MO&O, MOOR, 4 3NPT ,*<ONSS. 
MOCflI,MTOP,MOSTR,MEOT,'<FLAG,M4FTS,',MOPM,M4$ru, 
MNCEL,MNCLS,MNCLT , )NCUF,MNHI5,mn0PA,MNPLT,MN°T0, 
NNSTP,  MNSH4  ,.MNV4P  , PNl/PP,  MOPNO  , «P4P“,  MPLOT  , MST4T, 
MST4T ,MTCHR,MXST4 , MY494.NOO 

ATPI9(3),JTRI9(2>» CSET (3eO>,NSET!40C>,MF4,MX<, 

MFE ( 3 ) , MLE ( 3 ) , NQ ( 3 ) 

IPCS,JPOS,KPOS  ,LpCS,MPOS ,NPA, NAN, I£PRW , I EPP  F, IF  IN, 
I IECH,  INOXS,  INOXI,  INOX  , JNOX,  KNOX,  IP.NIIMFL,  ICON?, 
IISEO.HIOAL, IBLNK, IZERO.LA ,L3,LC,L0,LF,LF,LG,Li ,Lt 
t J,LK,LL,LM,  LN,LO,LP,UQ,LP,LS,LT,l'J,LV,LM,LX,LY  ,LZ 
IOFAL (4) ,KPEAO<40  > , IFLAG (50) , IPSUL (50)  ,PESUL(5C ) , 

I AEC ( 3 , 50) ,KAPO(3G),IOIG(9) 

NPROJ, MON, NOAY.NYR, NAME! 2) ,npun,npuns,nsksr, 

NSKST .LLC70, NNEOO.MNEOS, NNEOT 

TNCW, TTNEX ,MFAD,SEEO, I SEEO , NC POP , NP* NT ,NpUNCM, 
NPMT,NPENT,MN0C,NCC,N07N,NNTC 

NOE, NOPAT, nsyat ,nogp»nnm,nnpa , nmofn,nn,nprms,iflpr 
JFLPP, KPNK, XINN, NFL  AG, NNCLT, NNH IS , NMPL T , NNS T A , 
NNSTP.NPLOT ,NSTTS 

NEIP,NEIS,NSIP,NSIS,ITPACE, jTPACE.NPTSP.NRrEP, 
KT9ACE, MTPACE,  IIPSR, IISSP, IGRAF, JGRAF, I J TRAC, 
NSVVS, NS7VE, NTSOE, NTSOS, LTRACE ,NRT$S,NRTES 
PAKAM(100,5),N°T3U(100),PARM1(10C),PARM4(1C0) 

C ACINI  IOC, 3)  , ITCHR (10  0) ,LLTS< ( 103 ,2) »LSINK( ICO) . 
MACINI 130, 4)  , MF£N ( 13  0) , MF  STT ( ICO) ,NFTEU( 10  0 ) , 

MOP (ICO ) , MPO (10  0) * fOCH (10 j ,2)  , NOEL (1 00) , NOP T( ICO  1 , 
NPARI10  0 ),NPO(100)  , NPO  OR  ( 1 0 0 ) ,NPOOS(100>  ,NPOP(10C) 
NPCR(ICO) , NPSGN(IOO) ,MREL (10  0 1 ,NRELP( ICO ) , 
NREL2(lC3) , NS  I GN< 1 0 0 ) , NTC ( 1 0 0 > , NT  CHR ( 1 G 0 ) , 

NTYPE  (103)  .KMARKdCO)  ,XMARK(  ICC) 

3USYI20) , LLRES ( 2C , 2) ,N3US (20  > , NOPTR (20 ) , TLST<  20)  , 
NOP 4(603), PSTAT (80) 

YABA(85fl),NA9A(250),STCHR(200) 

MOPNS (20) , MFSTW (20 ) ,MFSTU(300 ) 

NS  INK (50) ,KSTPE(50 ) .KSTTMC50) , XSTUSI5G) ,NCELS (50 ) , 
XLCMI50) ,NIOTH(50I  , SUM A I (50 ,5  I ,SUMAF (50,5) , 

JCELS ( 135  0 ) 

OESCRI 1000 ) ,00 ATT (100) ,NOSTR( 8C0) ,SYSAT(100) 
AAERR.OTNAX.OTMIN.OTSAY, IITES,LLERR,RRFRR,TTLAS , 
TTS4V,0TSUG,DTFUL,0TN0W,ISEES,9E3LS,0TACC.LLSAV, 
LSAVE 

SSI  10  0)  , SSL  (10  0),  00  (100)  ,OOL  (ICO)  ,USVR»100  ,2) 
ISI20) ,NA9AO(300) »YA9AR(6flO> 

LFLAGI20) ,NPOSS (20 ) , NPO ST ( 20 ) ,LL MON (23.2) * 

NAB  AT  (40)  ,NABAS(feO)  .THRESU2  0 ) 

NSTAI (201 ,LLSVS (20 ,2) .SSTPVI20 ,6) 

OTPLT (10), IITAP (10  > .NNPTS110)  ,NNV4R (10) , NNVPI 10)  , 
LLPLT.NNPT ,LLPHI(10),LLPLO(10 ) ,LLSYM(lC)  ,PP HI (10 ) , 
PPL 0(13), NVP(IOO) , LLSVP  1 11 , 2 ) .CPSETCllOO) 
TTIME.PFIR9 

LLUGC 120,2) ,USOBV (20,5) ,LLUGT (20,2) ,TTCLR(20) . 
USTPl/ (20,6) , LL  UGH (20,2) ,NNO£L ( 20  I , HHL OW C 20 > , 

HHWIO  ( 20)  , JJCEL  ( 540 

OPLOT(IO), ITAPE(IO)  ,NPTSV(13)  , MVARS ( 1 0 ) , LPL OT , 
NPTEX,LPHIH(1C ) ,LRLOW (10 ) ,LSYMB(10).PHIH(10), 

PLOW  ( 10 ) ,LLUGP  ( 11 , 2)  .UPSET  (110  0) 


Figure  7(1).  Main  Program  for  SAINT. 
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THIS  PAGE  IS  BEST  QUALITY  PRACTIOBfiS 
FROM  COPY  FURBISHED  TO  BDC.  , ^ 


[MTiaLiZ!  =En,  frint,  ano  punch  keys 

C 

NCR0R*5 

NPRNTiij 
NP'JNCH*7 
NPN  I T =8 
N R E N T = 9 


****CEFINE  VARIAELES  WHICH  REPRESENT  ARRAY  NAXIHA  AND  SIHULATION 
♦“••UNITS 

10*100 
IHN=1C0 
I WN  A*  250 
MAX  CS  = 1 0 0 0 
“CAD=300 
HOOR=6CO 
HCN»T=A0 
MGNSS=60 
HQOAT=1GO 
“oop*u:o 
M0STR=8t0 
HEQ  T * 1 0 0 
wFl  AG*  20 
HHQFN=2C 
HHSTU=300 
NNCEL  *540 
HNCLS* 1 350 
HNCL  T = 20 
NNCUP* 1 100 
HNM IS*20 
HNOPA=6C0 
HNPL  T * 10 
HSSTP*20 
HNS  HA  = 20 
"Ntf  A R* 10 
HM/PP=10 
HCPNO=20 
MPARH=100 
mfl  ot*io 
NST  AT* 20 
HSYAT=100 
HTCHR*200 
MXS  T A*50 
NYA3A=150 

••••EXECUTION  CYCLE  --  READ  INPLT  OATA,  THEN  INITIATE  THE  SIHULATION 
IFI N*  0 

ICO  CALL  OATIN 

IFCIERRF.EQ.O)  CALL  GASP 
IFI IERRF.EO. 0)  CALL  SUHRY 
IF  IIFIN.EO.OI  GO  TO  130 
STOP 
C 

ENO 


Figure  7(2).  Main  Program  for  SAINT. 
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TABLE  17 


SAINT  COMMON  BLOCK  CHARACTERISTICS 


COMMON  Block 

Characteristics 

COMOl 

Maximum  Array  Dimensions 

COMO  2 

Filing  System 

COMO  3 

Input  Processing  I 

COMO  4 

Input  Processing  II 

COMO  5 

General  Information 

COMO  6 

Simulation  Control 

COMO  7 

Program  Options 

COMO  8 

Output  Options 

COMO  9 

Distribution  Sets 

COMIO 

Tasks  I 

COM11 

Resources 

COM12 

Tasks  II 

COM13 

Moderator  Functions  I 

COM14 

Statistics  Tasks 

COM15 

Attributes 

COM16 

State  Variable  Updating 

COM17 

State  Variables 

COM18 

Switching  and  Regulation 

COM19 

State  Variable  Monitors 

COM20 

State  Variable  Statistics 

COM21 

State  Variable  Plots 

COM2  2 

Moderator  Functions  II 

COM2  3 

User-Generated  Statistics 

COM2  4 

User-Generated  Plots 
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COMMON  BLOCKS  INCLUDED  IN  SAINT  SUBPROGRAMS 
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IMPSA 
IMP  ST 
iMPSV 


Subprogram  COMMON  Block  Number 
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SUMRY 

TASK 

TCLEAR 


Subprogram  COMMON  Block  Number 
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